虚拟方法

GioResolverlookup_records

自：2.34

声明 [源]

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

描述 [源]

同步执行给定 rrname 的 DNS 记录查找，并返回一个记录列表作为 GVariant 元组。有关记录内容的信息，请参阅 GResolverRecordType。

如果 DNS 解析失败，则 error（如果非 NULL）将被设置为来自 GResolverError 的值，并且将返回 NULL。

如果 cancellable 非空，则可以用于取消操作，在这种情况下，error（如果非空）将被设置为 G_IO_ERROR_CANCELLED。

自：2.34

参数

rrname

类型： const gchar*

查找记录的 DNS 名称。

数据由方法调用者拥有。

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

record_type

类型： GResolverRecordType

要查找的 DNS 记录类型。

cancellable

类型： GCancellable

GCancellable，或 NULL。

参数可以为空。

数据由方法调用者拥有。

error

类型： GError **

一个 recoverable 错误的返回位置。

参数可以为空。

如果返回位置不为空，则必须将其初始化为空 GError*。

如果虚拟函数没有错误，则该参数将通过函数保留初始化为空的。

如果发生错误，则参数将设置为一个新分配的 GError；调用者将获取数据的所有权，并负责释放它。

返回值

类型： 一个 GVariant* 列表

非空的GList列表的GVariant，或者错误时返回NULL。您必须在完成使用后释放每个记录和列表。（您可以使用g_list_free_full()配合g_variant_unref()来执行此操作。）

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