方法

GioSocketconnect

since: 2.22

声明 [src]

gboolean
g_socket_connect (
  GSocket* socket,
  GSocketAddress* address,
  GCancellable* cancellable,
  GError** error
)

描述 [src]

将套接字连接到指定的远程地址。

对于面向连接的套接字,这通常意味着我们尝试连接到 address。对于无连接的套接字,它设置 g_socket_send() 的默认地址,并丢弃来自其他来源的所有数据报。

通常,面向连接的套接字只能连接一次,但无连接的套接字可以多次连接以更改默认地址。

如果连接调用需要执行网络 I/O,它将阻塞,除非启用了非阻塞 I/O。那么返回 G_IO_ERROR_PENDING,用户可以通过等待 G_IO_OUT 条件来通知连接完成。然后将使用 g_socket_check_connect_result() 检查连接的结果。

自 2.22 版本起可用。

参数

address

类型: GSocketAddress

指定远程地址的 GSocketAddress

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

类型: GCancellable

一个 %GCancellable 或 NULL

该参数可以是 NULL
数据由方法调用者拥有。
error

类型: GError **

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

该参数可以是 NULL
如果返回位置不是 NULL,则必须将其初始化为一个 NULL GError*
如果没有错误,方法将保留初始化为 NULL 的参数。
发生错误时,该参数将设置为一个新的 GError;调用者将拥有数据,并负责释放它。

返回值

类型: gboolean

TRUE 如果连接成功,FALSE 如果发生错误。