DtlsConnectionIF.close

Close the DTLS connection. This is equivalent to calling g_dtls_connection_shutdown() to shut down both sides of the connection.

Closing a #GDtlsConnection waits for all buffered but untransmitted data to be sent before it completes. It then sends a close_notify DTLS alert to the peer and may wait for a close_notify to be received from the peer. It does not close the underlying #GDtlsConnection:base-socket; that must be closed separately.

Once @conn is closed, all other operations will return %G_IO_ERROR_CLOSED. Closing a #GDtlsConnection multiple times will not return an error.

#GDtlsConnections will be automatically closed when the last reference is dropped, but you might want to call this function to make sure resources are released as early as possible.

If @cancellable is cancelled, the #GDtlsConnection may be left partially-closed and any pending untransmitted data may be lost. Call g_dtls_connection_close() again to complete closing the #GDtlsConnection.

interface DtlsConnectionIF
bool
close

Parameters

cancellable Cancellable

a #GCancellable, or %NULL

Return Value

Type: bool

%TRUE on success, %FALSE otherwise

Throws

GException on failure.

Meta

Since

2.48