1 2 3 4 5@deftypefun {int} {gnutls_pkcs11_obj_list_import_url4} (gnutls_pkcs11_obj_t ** @var{p_list}, unsigned int * @var{n_list}, const char * @var{url}, unsigned int @var{flags}) 6@var{p_list}: An uninitialized object list (may be NULL) 7 8@var{n_list}: It will contain the size of the list. 9 10@var{url}: A PKCS 11 url identifying a set of objects 11 12@var{flags}: Or sequence of GNUTLS_PKCS11_OBJ_* flags 13 14This function will enumerate all the objects specified by the PKCS@code{11} URL 15provided. It will initialize and set values to the object pointer list ( @code{p_list} ) 16provided. To obtain a list of all available objects use a @code{url} of 'pkcs11:'. 17 18All returned objects must be deinitialized using @code{gnutls_pkcs11_obj_deinit()} , 19and @code{p_list} must be deinitialized using @code{gnutls_free()} . 20 21The supported in this function @code{flags} are @code{GNUTLS_PKCS11_OBJ_FLAG_LOGIN} , 22@code{GNUTLS_PKCS11_OBJ_FLAG_LOGIN_SO} , @code{GNUTLS_PKCS11_OBJ_FLAG_PRESENT_IN_TRUSTED_MODULE} , 23@code{GNUTLS_PKCS11_OBJ_FLAG_CRT} , @code{GNUTLS_PKCS11_OBJ_FLAG_PUBKEY} , @code{GNUTLS_PKCS11_OBJ_FLAG_PRIVKEY} , 24@code{GNUTLS_PKCS11_OBJ_FLAG_WITH_PRIVKEY} , @code{GNUTLS_PKCS11_OBJ_FLAG_MARK_CA} , 25@code{GNUTLS_PKCS11_OBJ_FLAG_MARK_TRUSTED} , and since 3.5.1 the @code{GNUTLS_PKCS11_OBJ_FLAG_OVERWRITE_TRUSTMOD_EXT} . 26 27On versions of GnuTLS prior to 3.4.0 the equivalent function was 28@code{gnutls_pkcs11_obj_list_import_url2()} . That is also available on this version 29as a macro which maps to this function. 30 31@strong{Returns:} On success, @code{GNUTLS_E_SUCCESS} (0) is returned, otherwise a 32negative error value. 33 34@strong{Since:} 3.4.0 35@end deftypefun 36