方法

GioSocketClientconnect

自: 2.22

声明 [源]

GSocketConnection*
g_socket_client_connect (
  GSocketClient* client,
  GSocketConnectable* connectable,
  GCancellable* cancellable,
  GError** error
)

描述 [源]

尝试解析 connectable 并与它建立网络连接。

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

返回的 GSocketConnection 对象的类型取决于底层套接字的使用类型。例如，对于 TCP/IP 连接，它将是一个 GTcpConnection。

创建的套接字将与 connectable 解析到的地址族相同，除非使用 g_socket_client_set_family() 设置了地址族，或者通过 g_socket_client_set_local_address() 间接设置。套接字类型默认为 G_SOCKET_TYPE_STREAM，但可以通过 g_socket_client_set_socket_type() 设置。

如果使用 g_socket_client_set_local_address() 指定了本地地址，套接字将绑定到此地址后再连接。

自: 2.22

参数

connectable

类型: GSocketConnectable

指定远程地址的 GSocketConnectable。

该数据归方法调用者所有。

cancellable

类型: GCancellable

可选的 GCancellable 对象，使用 NULL 来忽略。

参数可以是 NULL。

该数据归方法调用者所有。

错误

类型： GError **

用于存储可恢复错误的返回位置。

参数可以是 NULL。

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

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

在发生错误的情况下，参数将被设置为一个新的 GError；调用者将承担数据的所有权，并负责释放它。

返回值

类型： GSocketConnection

在成功的情况下返回 GSocketConnection，在错误情况下返回 NULL。

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