@deftypefun {int} {gnutls_pkcs11_obj_list_import_url3} (gnutls_pkcs11_obj_t * @var{p_list}, unsigned int * @var{n_list}, const char * @var{url}, unsigned int @var{flags})

@var{p_list}: An uninitialized object list (may be @code{NULL} )

@var{n_list}: Initially should hold the maximum size of the list. Will contain the actual size.

@var{url}: A PKCS 11 url identifying a set of objects

@var{flags}: Or sequence of GNUTLS_PKCS11_OBJ_* flags

This function will initialize and set values to an object list

by using all objects identified by a PKCS 11 URL.

This function will enumerate all the objects specified by the PKCS@code{11}  URL

provided. It expects an already allocated  @code{p_list} which has * @code{n_list} elements,

and that value will be updated to the actual number of present objects. The

 @code{p_list} objects will be initialized and set by this function.

To obtain a list of all available objects use a  @code{url} of 'pkcs11:'.

All returned objects must be deinitialized using @code{gnutls_pkcs11_obj_deinit()} .

The supported in this function  @code{flags} are @code{GNUTLS_PKCS11_OBJ_FLAG_LOGIN} ,

@code{GNUTLS_PKCS11_OBJ_FLAG_LOGIN_SO} , @code{GNUTLS_PKCS11_OBJ_FLAG_PRESENT_IN_TRUSTED_MODULE} ,

@code{GNUTLS_PKCS11_OBJ_FLAG_CRT} , @code{GNUTLS_PKCS11_OBJ_FLAG_PUBKEY} , @code{GNUTLS_PKCS11_OBJ_FLAG_PRIVKEY} ,

@code{GNUTLS_PKCS11_OBJ_FLAG_WITH_PRIVKEY} , @code{GNUTLS_PKCS11_OBJ_FLAG_MARK_CA} ,

@code{GNUTLS_PKCS11_OBJ_FLAG_MARK_TRUSTED} , and since 3.5.1 the @code{GNUTLS_PKCS11_OBJ_FLAG_OVERWRITE_TRUSTMOD_EXT} .

On versions of GnuTLS prior to 3.4.0 the equivalent function was

@code{gnutls_pkcs11_obj_list_import_url()} . That is also available on this version

as a macro which maps to this function.

@strong{Returns:} On success, @code{GNUTLS_E_SUCCESS}  (0) is returned, otherwise a

negative error value.

@strong{Since:} 3.4.0

@end deftypefun