gss_duplicate_name(3) — Subroutines
NAME
gss_duplicate_name − Copy existing internal form name.
SYNOPSIS
#include <gssapi/gssapi.h>
OM_uint32 gss_duplicate_name(
OM_uint32 ∗ minor_status,
const gss_name_t src_name,
gss_name_t ∗ const dest_name );
PARAMETERS
minor_status
Kerberos 5 error code.
src_name
Internal form name to be duplicated. The application must obtain the internal form name beforehand using a call such as gss_import_name().
dest_name
The resulting copy of the internal name.
Storage associated with this name must be freed by the application after use with a call to gss_release_name().
DESCRIPTION
The gss_duplicate_name() function creates an exact copy of an existing internal form name. The new name is independent of the original name. This means both names must both be released after use, and that the release of one does not affect the validity of the other.
Storage associated with the duplicate name must be freed by the application after use with a call to gss_release_name().
RETURN VALUES
| GSS_S_BAD_NAME | xx02xxxx |
| GSS_S_CALL_INACCESSIBLE_READ | 01xxxxxx |
| GSS_S_CALL_INACCESSIBLE_WRITE | 02xxxxxx |
| GSS_S_COMPLETE | 00000000 |
| GSS_S_FAILURE | xx0Dxxxx |