Function
GcrPkcs11Certificatenew_from_uri
Declaration [src]
GcrCertificate*
gcr_pkcs11_certificate_new_from_uri (
const gchar* pkcs11_uri,
GCancellable* cancellable,
GError** error
)
Description [src]
Lookup a certificate in the PKCS#11 storage by the given URI.
This call may block, see gcr_pkcs11_certificate_new_from_uri_async() for the
non-blocking version.
Will return NULL if no certificate is found. Use error to determine
if an error occurred.
Parameters
pkcs11_uri-
Type:
const gchar*A A PKCS #11 URI.
The data is owned by the caller of the function. The value is a NUL terminated UTF-8 string. cancellable-
Type:
GCancellableA
GCancellable.The argument can be NULL.The data is owned by the caller of the function. error-
Type:
GError **The return location for a recoverable error.
The argument can be NULL.If the return location is not NULL, then you must initialize it to aNULLGError*.The argument will left initialized to NULLby the function if there are no errors.In case of error, the argument will be set to a newly allocated GError; the caller will take ownership of the data, and be responsible for freeing it.
Return value
Type: GcrCertificate
A new GcrCertificate, or NULL.
| The caller of the function takes ownership of the data, and is responsible for freeing it. |
The return value can be NULL. |