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 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 GCancellable
 

A GCancellable.

 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: 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.