HP Open Source Security for OpenVMS Volume 3: Kerberos > Chapter 5 GSSAPI (Generic Security Services Application Programming Interface)

gss_duplicate_name — Create a copy of an internal name

 » Table of Contents

 » Glossary

 » Index

C Prototype

OM_uint32 gss_duplicate_name(
OM_uint32 * minor_status,
const gss_name_t input_name,
gss_name_t * dest_name );

Arguments

minor_status (output)  

An implementation-specific status code.

input_name (input) 

The internal name to be duplicated.

dest_name (output) 

The resultant copy of input_name. Storage associated with this name must be freed by the application after use by a call to gss_release_name.

Description

This routine creates a duplicate of the existing internal name input_name. The new dest_name will be independent of input_name (that is, input_name and dest_name must both be released, and the release of one will not affect the validity of the other).

Return Values

This routine returns one of the following GSS status codes:

GSS_S_COMPLETE

Successful completion.
GSS_S_BAD_NAMEThe input_name argument was ill formed.