HP Open Source Security for OpenVMS Volume 3: Kerberos > Chapter 6 KRB5 (Kerberos V5) Application Programming Interface

krb5_unparse_name — Convert protocol format principal name to string format

  Table of Contents



C Prototype

krb5_error_code krb5_unparse_name (
krb5_context context,
krb5_const_principal principal,
char **name );


context (input/output) 

The context structure.

principal (input) 

Multipart principal format used in the protocols.

name (output) 

Single string representation of a Kerberos principal name.


This routine converts the multipart principal name principal from the format used in the protocols to a single-string representation of the name. The resulting single-string representation will use the format and quoting conventions described for krb_parse_name.

The *name argument points to allocated storage and should be freed by the caller when finished.

Return Values

This routine returns one of the following KRB5 status codes:

0Successful completion.


Insufficient memory.