shisa_enumerate_principals3
Api function
Usage
#include <shisa.h>
int shisa_enumerate_principals(Shisa * dbh, const char * realm, char *** principals, size_t * nprincipals);
Arguments
- Shisa * dbh
-
Shisa library handle created by
shisa().
- const char * realm
-
Name of realm, as null-terminated UTF-8 string.
- char *** principals
-
Returned pointer to newly allocated array of just allocated null-terminated UTF-8 strings with principal names.
- size_t * nprincipals
-
Pointer to an integer updated with the number of just allocated and returned principal names.
Overview
Extracts a list of all principal names in backend belonging to the realm realm, as null-terminated UTF-8 strings. The caller is responsible for deallocating all strings and the array *principals.
Return value
Returns SHISA_OK on success, SHISA_NO_REALM if the specified realm does not exist, or an error code otherwise.
Releases
10 releases since Debian 4.0 (Etch); the text changed 5 times.