方法

GioResolverlookup_records

自：2.34

声明 [src]

GList*
g_resolver_lookup_records (
  GResolver* resolver,
  const gchar* rrname,
  GResolverRecordType record_type,
  GCancellable* cancellable,
  GError** error
)

描述 [src]

同步地执行给定 rrname 的 DNS 记录查找，并返回记录列表作为 GVariant 元组。有关每个 record_type 所包含信息，请参阅 GResolverRecordType。

如果 DNS 解析失败，如果 error (如果非 NULL) 被设置为 GResolverError 的一个值，则返回 NULL。

如果 cancellable 非 NULL，则可用于取消操作，在这种情况下，如果 error (如果非 NULL)，将被设置为 G_IO_ERROR_CANCELLED。

自 2.34 以来可用

参数

rrname

类型：const gchar*

要查找记录的 DNS 名称。

数据由该方法调用者拥有。

值是一个空终止的 UTF-8 字符串。

record_type

类型：GResolverRecordType

要查找的 DNS 记录的类型。

cancellable

类型：GCancellable

一个 GCancellable，或 NULL。

该参数可以为 NULL。

数据由该方法调用者拥有。

error

类型：GError **

用于一个可恢复错误的返回位置。

该参数可以为 NULL。

如果返回位置不是 NULL，则必须将其初始化为一个 NULL 的 GError*。

如果没有错误，方法将保留初始化的参数为 NULL。

出现错误时，参数将被设置为一个新的 GError；调用者将拥有数据的所有权，并负责释放它。

返回值

类型: 一组 GVariant*

一个非空的 GList 包含 GVariant，或者在错误时为 NULL。您必须在使用完毕后释放每个条目和列表。（您可以使用 g_list_free_full() 结合 g_variant_unref() 来完成此操作。）

方法调用者拥有返回数据的所有权，并负责释放它。