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:
GCancellable
A
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 aNULL
GError*
.The argument will be left initialized to NULL
by 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 . |