sec_id_gen_name-Generate a global principal name from cell and principal UUIDs
#include <dce/secidmap.h> void sec_id_gen_name ( sec_rgy_handle_t context, uuid_t *cell_idp, uuid_t *princ_idp, sec_rgy_name_t global_name, sec_rgy_name_t cell_namep, sec_rgy_name_t princ_namep, error_status_t *status );
An opaque handle bound to a registry server. Use sec_rgy_site_open() to acquire a bound handle.
A pointer to the UUID of the home cell of the principal whose name is in question.
A pointer to the UUID of the principal whose name is in question.
The global (full) name of the principal in sec_rgy_name_t form (see
Global PGO Names).
The name of the principal's home cell in sec_rgy_name_t form.
The local (with respect to the home cell) name of the principal in sec_rgy_name_t form.
A pointer to the completion status. On successful completion, the function returns error_status_ok. Otherwise, it returns an error.
sec_id_gen_name()routine generates a global name from input cell and principal UUIDs. For example, given a UUID specifying the cell /.../world/hp/brazil, and a UUID specifying a principal resident in that cell named writers/tom, the routine would return the global name of that principal, in this case, /.../world/hp/brazil/writers/tom. It also returns the simple names of the cell and principal, translated from the UUIDs.
The routine will not produce translations to any name for which a NULL pointer has been supplied.
sec_id_gen_name()routine requires at least one permission of any kind on the account associated with the input cell and principal UUIDs.
The idl file from which dce/secidmap.h was derived.
The call was successful.
The cell UUID is not valid.
The name is too long for current implementation.
The registry server could not find the specified principal.
The DCE Registry Server is unavailable.
sec_id_gen_group(), sec_id_parse_group(), sec_id_parse_name().