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

krb5_build_principal_va — Fill in pointer to principal structure

 » Table of Contents

 » Glossary

 » Index

spacerspacerspacer
spacer
spacer
  		 
 

C Prototype

krb5_error_code krb5_build_principal_va(
        krb5_context    context,
        krb5_principal  princ,
        int             rlen,
        const char      *realm,
        va_list         ap );

Arguments

context (input/output) 

The context structure.

princ (output) 

The principal structure.

rlen (input) 

Realm name length.

realm (input) 

Realm name.

ap (input)  

A list of null-terminated strings.

Description

krb5_build_principal and krb5_build_principal_va perform the same function; the former takes variadic arguments, while the latter takes a pre-computed varargs pointer.Both functions take a realm name realm, realm name length rlen, and a list of null-terminated strings, and fill in a pointer to a principal structure princ, making it point to a structure representing the named principal. The last string must be followed in the argument list by a null pointer.

Return Values

This routine returns the following KRB5 status codes:

0

Successful completion.

ENOMEM

Insufficient memory.



krb5_build_principal — Build a principal name
  		 


krb5_c_block_size — Get the block size for the given encryption type