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: GSSAPI (Generic Security Services Application... GSSAPI (Generic Security Services Application...
go to previous page: gss_duplicate_name  Create a copy of an internal name gss_duplicate_name Create a copy of an internal name
go to next page: gss_export_sec_context  Transfer a security context to another processgss_export_sec_context Transfer a security context to another...
end of book navigation links

gss_export_name -- Convert an internal mechanism name to export form 



C Prototype 

OM_uint32 gss_export_name(
        (OM_uint32         minor_status,
        const gss_na       input_name,
        gss_buffer_t       exported_name );

Arguments 

minor_status
(output)
 An implementation-specific status code.
input_name (input) The mechanism name to be exported.
exported_name (output) The canonical contiguous string form of input_name. Storage associated with this string must be freed by the application after use by a call to gss_release_buffer.

Description 

This routine produces a canonical contiguous string representation of a mechanism name (MN), suitable for direct comparison (for example, with memcmp) for use in authorization functions (for example, matching entries in an access-control list). The input_name argument must specify a valid MN (that is, an internal name generated by gss_accept_sec_context or by gss_canonicalize_name).

Return Values 

This routine returns one of the following GSS status codes:

GSS_S_COMPLETE
Successful completion.
GSS_S_NAME_NOT_MN
The provided internal name was not a mechanism name.
GSS_S_BAD_NAME
The provided internal name was ill formed.
GSS_S_BAD_NAMETYPE
The internal name was of a type not supported by the GSSAPI implementation.


go to previous page: gss_duplicate_name  Create a copy of an internal name gss_duplicate_name Create a copy of an internal name
go to next page: gss_export_sec_context  Transfer a security context to another processgss_export_sec_context Transfer a security context to another...