NAME

CSSM_GetSubserviceUIDFromHandle

SYNOPSIS

CSSM_SUBSERVICE_UID_PTR CSSMAPI CSSM_GetSubserviceUIDFromHandle
    (CSSM_HANDLE ModuleHandle,
    const CSSM_MEMORY_FUNCS_PTR MemoryFuncs)

DESCRIPTION

This function returns the unique identifier of the attached module subservice, as identified by the input handle. If provided, the MemoryFuncs override the CSSM's default memory functions which were set by the most recent call to CSSM_Init.

PARAMETERS

ModuleHandle (input)

Handle of the module subservice for which the subservice unique identifier should be returned.

MemoryFunctions (input/optional)

A table of API_MEMORY_FUNCS pointers. CSSM uses these functions to perform memory management operations on behalf of the caller during the service of this function call. If no table of functions is specified, CSSM uses the default memory management functions set by the caller's most recent call to the CSSM_Init function.

RETURN VALUE

Non-NULL if the function was successful. NULL if an error condition occurred. Use CSSM_GetError to obtain the error code.

ERRORS

CSSM_INVALID_MODULE_HANDLE

Invalid add-in handle.

SEE ALSO

CSSM_GetGUIDFromHandle