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_compare_name  Allow application to compare two internal names gss_compare_name Allow application to compare two internal names
go to next page: gss_context_time  Check how much longer context is validgss_context_time Check how much longer context is valid
end of book navigation links

gss_canonicalize_name -- Convert internal name to internal mechanism name 



C Prototype 

 OM_uint32 gss_canonicalize_name(
        OM_uint32              minor_status,
        const gss_name_t       input_name,
        const gss_OID          mech_type,
        gss_name_t             output_name );

Arguments 

minor_status
(output)
 An implementation-specific status code.
input_name (input) The name for which a canonical form is desired.
mech_type (input) The authentication mechanism for which the canonical form of the name is desired. The desired mechanism must be specified explicitly; no default is provided.
output_name (output) The resultant canonical name. Storage associated with this name must be freed by the application after use by a call to gss_release_name.

Description 

This routine generates a canonical mechanism name (MN) from an arbitrary internal name. The mechanism name is the name that would be returned to a context acceptor on successful authentication of a context where the initiator used the input_name in a successful call to gss_acquire_cred, specifying an OID set containing mech_type as its only member, followed by a call to gss_init_sec_context, specifying mech_type as the authentication mechanism.

Return Values 

This routine returns one of the following GSS status codes:

GSS_S_COMPLETE
Successful completion.
GSS_S_BAD_MECH
The identified mechanism is not supported.
GSS_S_BAD_NAMETYPE
The provided internal name contains no elements that could be processed by the specified mechanism.
GSS_S_BAD_NAME
The input_name argument was ill formed.


go to previous page: gss_compare_name  Allow application to compare two internal names gss_compare_name Allow application to compare two internal names
go to next page: gss_context_time  Check how much longer context is validgss_context_time Check how much longer context is valid