Virtual Method
GioTlsDatabaselookup_certificate_for_handle
Declaration
GTlsCertificate*
lookup_certificate_for_handle (
GTlsDatabase* self,
const gchar* handle,
GTlsInteraction* interaction,
GTlsDatabaseLookupFlags flags,
GCancellable* cancellable,
GError** error
)
Description
Look up 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.
Available since: | 2.30 |
Parameters
handle |
const gchar* |
A certificate handle. |
|
The data is owned by the caller of the function. | |
The value is a NUL terminated UTF-8 string. | |
interaction |
GTlsInteraction |
Used to interact with the user if necessary. |
|
The argument can be NULL . | |
The data is owned by the caller of the function. | |
flags |
GTlsDatabaseLookupFlags |
Flags which affect the lookup. |
|
cancellable |
GCancellable |
A |
|
The argument can be NULL . | |
The data is owned by the caller of the function. | |
error |
GError ** |
The return location for a GError* , or NULL . |
Return value
Returns: | GTlsCertificate |
A newly allocated
|
|
The caller of the function takes ownership of the data, and is responsible for freeing it. | |
The return value can be NULL . |