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

krb5_set_principal_realm — Set the realm in the current context

  Table of Contents



C Prototype

krb5_error_code krb5_set_principal_realm (
krb5_context context,
krbt5_principal principal,
const char *realm );


context (input/output) 

The context structure.

principal (input) 

The Kerberos principal name.

realm (input) 

The new realm to which the context should be set.


This routine sets the realm in the current context to realm.

Return Values

This routine returns the following KRB5 status codes:


Successful completion.

EINVALInvalid parameter.


Insufficient memory.