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

krb5_set_default_realm — Sets the default realm

  Table of Contents



C Prototype

krb5_error_code krb5_set_default_realm(
krb5_context context,
char *realm );


context (input) 

The context structure.

realm (output) 

The default realm to be set. If realm is NULL, then the operating system default value will used.


This routine sets the default realm to be used if no user-specified realm is available (for example, to interpret a user-typed principal name with the realm omitted for convenience).

Return Values

This routine returns the following KRB5 status code:

0Successful completion.


Insufficient memory.