NAME

CSSM_GetContext

SYNOPSIS

CSSM_CONTEXT_PTR CSSMAPI CSSM_GetContext
    (CSSM_CC_HANDLE CCHandle)

DESCRIPTION

This function retrieves the context information when provided with a context handle.

PARAMETERS

CCHandle (input)

The handle to the context information.

RETURN VALUE

The pointer to the CSSM_CONTEXT structure that describes the context associated with the handle CCHandle. If the pointer is NULL, an error has occurred. Use CSSM_GetError to obtain the error code. Call CSSM_FreeContext to free the memory allocated by the CSSM.

ERRORS

CSSM__INVALID_CONTEXT_HANDLE

Invalid context handle.

CSSM__MEMORY_ERROR

Unable to allocate memory.

CSSM__MEMORY_ERROR

Internal Memory Error.

SEE ALSO

CSSM_SetContext, CSSM_FreeContext