虚函数

GioSocketAddressEnumeratornext

声明 [源]

GSocketAddress*
next (
  GSocketAddressEnumerator* enumerator,
  GCancellable* cancellable,
  GError** error
)

描述 [源]

从枚举器中检索下一个 GSocketAddress。注意，这可能会阻塞一段时间。（例如，一个 GNetworkAddress 需要在返回地址之前执行 DNS 查询。）如果需要避免阻止，请使用 g_socket_address_enumerator_next_async()。

如果期望枚举器产生地址，但由于某种原因无法产生（例如，因为 DNS 错误），则对 g_socket_address_enumerator_next() 的第一次调用将在 *error 中返回适当的错误。但是，如果对 g_socket_address_enumerator_next() 的第一次调用成功，则任何进一步的内联错误（除了 cancellable 被触发）将被忽略。

参数

cancellable

类型: GCancellable

可选的 GCancellable 对象，NULL 表示忽略。

此参数可以为 NULL。

数据由方法调用者所有。

error

类型: GError **

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

此参数可以为 NULL。

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

如果没有错误，虚拟函数会将参数初始化为 NULL。

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

返回值

类型: GSocketAddress

一个 GSocketAddress（由调用者所有），或者在错误（在这种情况下，将设置 *error）或没有更多地址时为 NULL。

方法的调用者将接管返回的数据并负责释放它。

返回值可以为 NULL。