方法

GioSocketClientconnect_to_service

声明 [源]

GSocketConnection*
g_socket_client_connect_to_service (
  GSocketClient* client,
  const gchar* domain,
  const gchar* service,
  GCancellable* cancellable,
  GError** error
)

描述 [源]

尝试创建到服务的TCP连接。

此调用在“tcp”协议中的domain域名查找service的SRV记录。然后,依次尝试连接到提供该服务的每个主机,直到连接成功或没有更多主机为止。

成功连接后,将构建一个新的GSocketConnection并返回。调用者拥有此新对象,并在完成时必须释放其引用。

在任何失败的情况下(DNS错误、找不到服务、无连接主机)将返回NULL,并且(如果非NULL)相应地设置error

参数

domain

类型: const gchar*

域名。

数据属于方法调用者。
值是NUL终止的UTF-8字符串。
service

类型: const gchar*

要连接到的服务的名称。

数据属于方法调用者。
值是NUL终止的UTF-8字符串。
cancellable

类型: GCancellable

GCancellable,或NULL

参数可以是NULL
数据属于方法调用者。
error

类型: GError **

恢复性错误的返回位置。

参数可以是NULL
如果返回位置不是NULL,则必须将其初始化为NULLGError*
如果没有错误,则方法将通过保留初始化将参数留为NULL
如果出现错误,参数将被设置为一个新的分配的GError;调用者将取得数据的所有权,并负责释放它。

返回值

类型: GSocketConnection

如果成功,返回GSocketConnection;如果出错,则返回NULL

该方法调用者取得返回数据的所有权,并负责释放它。