HP OpenVMS Systems Documentation
Content starts here
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

spacerspacerspacer
spacer
spacer
  		 
 

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.



gss_display_status — Convert GSSAPI status code to text for user display
  		 


gss_export_name — Convert an internal mechanism name to export form