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

  Glossary

  Index

C Prototype

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

Arguments

context (input/output) 

The context structure.

principal (input) 

The Kerberos principal name.

realm (input) 

The new realm to which the context should be set.

Description

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

Return Values

This routine returns the following KRB5 status codes:

0

Successful completion.

EINVALInvalid parameter.

ENOMEM

Insufficient memory.