1
2
3
4
5@deftypefun {int} {gnutls_pkcs11_obj_import_url} (gnutls_pkcs11_obj_t @var{obj}, const char * @var{url}, unsigned int @var{flags})
6@var{obj}: The structure to store the object
7
8@var{url}: a PKCS 11 url identifying the key
9
10@var{flags}: Or sequence of GNUTLS_PKCS11_OBJ_* flags
11
12This function will "import" a PKCS 11 URL identifying an object (e.g. certificate)
13to the @code{gnutls_pkcs11_obj_t}  type. This does not involve any
14parsing (such as X.509 or OpenPGP) since the @code{gnutls_pkcs11_obj_t}  is
15format agnostic. Only data are transferred.
16
17If the flag @code{GNUTLS_PKCS11_OBJ_FLAG_OVERWRITE_TRUSTMOD_EXT}  is specified
18any certificate read, will have its extensions overwritten by any
19stapled extensions in the trust module.
20
21@strong{Returns:} On success, @code{GNUTLS_E_SUCCESS}  (0) is returned, otherwise a
22negative error value.
23
24@strong{Since:} 2.12.0
25@end deftypefun
26