方法
自:2.48
声明 [src]
gboolean
g_dtls_connection_shutdown (
GDtlsConnection* conn,
gboolean shutdown_read,
gboolean shutdown_write,
GCancellable* cancellable,
GError** error
)
描述 [src]
关闭DTLS连接的部分或全部。
如果shutdown_read
为TRUE
,则关闭连接的接收端,不允许进一步读取。随后调用g_datagram_based_receive_messages()
将返回G_IO_ERROR_CLOSED
。
如果shutdown_write
为TRUE
,则关闭连接的发送端,不允许进一步写入。随后调用g_datagram_based_send_messages()
将返回G_IO_ERROR_CLOSED
。
允许两者的shutdown_read
和shutdown_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
,那么您必须将其初始化为NULL
的GError*
。如果没有错误,该方法会将参数保留为 NULL
。在出错情况下,参数将被设置为一个新的 GError
;调用者将负责获取数据的所有权限,并负责释放它。