Find one collection role

saf_find_one_role is a function defined in role.c.

Synopsis:

SAF_Role * saf_find_one_role(SAF_Db *database, const char *name, SAF_Role *buf)

Formal Arguments:

  • database: The database in which to search
  • name: The name for which to search
  • buf: [OUT] Optional role handle to initialize and return.

Description: This is a convenience version of saf_find_roles that returns the first role it finds whose name matches that which is specified.

Return Value: A handle to a matching role on success; SAF__ERROR_HANDLE on failure.

See Also: