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

 » Glossary

 » Index

C Prototype

krb5_error_code krb5_set_default_realm(
krb5_context context,
char *realm );

Arguments

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.

Description

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.

ENOMEM

Insufficient memory.