TlsDatabase.lookupCertificateForHandle

Lookup a certificate by its handle. The handle should have been created by calling g_tls_database_create_certificate_handle() on a GTlsDatabase object of the same TLS backend. The handle is designed to remain valid across instantiations of the database. If the handle is no longer valid, or does not point to a certificate in this database, then NULL will be returned. This function can block, use g_tls_database_lookup_certificate_for_handle_async() to perform the lookup operation asynchronously. Since 2.30

Parameters

handle string

a certificate handle

interaction TlsInteraction

used to interact with the user if necessary. [allow-none]

flags GTlsDatabaseLookupFlags

Flags which affect the lookup.

cancellable Cancellable

a GCancellable, or NULL. [allow-none]

Return Value

a newly allocated GTlsCertificate, or NULL. Use g_object_unref() to release the certificate. [transfer full][allow-none]

Throws

GException on failure.

Meta