skip book previous and next navigation links
go up to top of book: HP Open Source Security for OpenVMS Volume 3:... HP Open Source Security for OpenVMS Volume 3:...
go to beginning of chapter: KRB5 (Kerberos V5) Application Programming Interface KRB5 (Kerberos V5) Application Programming Interface
go to previous page: krb5_build_principal  Build a principal name krb5_build_principal Build a principal name
go to next page: krb5_c_block_size  Get the block size for the given encryption typekrb5_c_block_size Get the block size for the given encryption...
end of book navigation links

krb5_build_principal_va -- Fill in pointer to principal structure 



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) A pointer to a 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.


go to previous page: krb5_build_principal  Build a principal name krb5_build_principal Build a principal name
go to next page: krb5_c_block_size  Get the block size for the given encryption typekrb5_c_block_size Get the block size for the given encryption...