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

krb5_get_host_realm — Get the Kerberos realm names for a host

 » Table of Contents

 » Glossary

 » Index

spacerspacerspacer
spacer
spacer
  		 
 

C Prototype

krb5_error_code krb5_get_host_realm(
         krb5_context      context,
         const char        *host,
         char              ***realmlist );

Arguments

context (input) 

The context structure.

host (input) 

The host name.

realmlist (output)  

A pointer to a list of realm names.

Description

This routine determines the Kerberos realm names for host, filling in realmlist with a pointer to an argv[ ] style list of names, terminated with a NULL pointer.

If host is NULL, the local host's realms are determined.

If there are no known realms for the host, the filled-in pointer is set to NULL.

The pointer array and strings pointed to are all in allocated storage, and should be freed by the caller when finished.

Return Values

This routine returns the following KRB5 status code:

0

Successful completion.

ENOMEM Insufficient memory.



krb5_get_init_creds_password — Get the initial credentials password
  		 


krb5_get_message — Convert an error code into the string representation