方法

自:2.48

声明 [src]

gboolean
g_dtls_connection_shutdown (
  GDtlsConnection* conn,
  gboolean shutdown_read,
  gboolean shutdown_write,
  GCancellable* cancellable,
  GError** error
)

描述 [src]

关闭DTLS连接的部分或全部。

如果shutdown_readTRUE,则关闭连接的接收端,不允许进一步读取。随后调用g_datagram_based_receive_messages()将返回G_IO_ERROR_CLOSED

如果shutdown_writeTRUE,则关闭连接的发送端,不允许进一步写入。随后调用g_datagram_based_send_messages()将返回G_IO_ERROR_CLOSED

允许两者的shutdown_readshutdown_write都为TRUE — 这相当于调用g_dtls_connection_close()。

如果cancellable被取消,GDtlsConnection可能处于部分关闭状态,并且任何挂起的未传输数据可能会丢失。再次调用g_dtls_connection_shutdown()以完成GDtlsConnection的关闭。

自2.48起可用

参数

shutdown_read

类型:gboolean

TRUE停止接收入站数据包。

shutdown_write

类型:gboolean

TRUE停止发送出站数据包。

cancellable

类型:GCancellable

一个GCancellable,或NULL

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

类型:GError **

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

该参数可以是NULL
如果返回位置不是 NULL,那么您必须将其初始化为 NULLGError*
如果没有错误,该方法会将参数保留为 NULL
在出错情况下,参数将被设置为一个新的 GError;调用者将负责获取数据的所有权限,并负责释放它。

返回值

类型:gboolean

成功则返回 TRUE,否则返回 FALSE