Previous section.

Common Security: CDSA and CSSM
Copyright © 1997 The Open Group

NAME

CSSM__DigestDataClone

SYNOPSIS

CSSM_CC_HANDLE CSSMAPI CSSM_DigestDataClone
    (CSSM_CC_HANDLE CCHandle)

DESCRIPTION

This function clones a given staged message digest context with its cryptographic attributes and intermediate result.

PARAMETERS

CCHandle (input)

The handle that describes the context of a staged message digest operation.

RETURN VALUE

The pointer to a user-allocated CSSM_CC_HANDLE for holding the cloned context handle return from CSSM. If the pointer is NULL, an error has occurred; use CSSM_GetError to obtain the error code.

ERRORS

CSSM__CSP_INVALID_CONTEXT_HANDLE

Invalid context handle.

CSSM__CSP_MEMORY_ERROR

Not enough memory to allocate.

CSSM__CSP_STAGED_OPERATION_UNSUPPORTED

Staged operation unsupported.

CSSM__CSP_STAGED_OPERATION_FAILED

Staged Cryptographic operation failed.

CSSM__CSP_GET_STAGED_INFO_ERROR

Cannot find or get the staged information.

Comments

When a digest context is cloned, a new context is created with data associated with the parent context. Changes made to the parent context after calling this function will not be reflected in the cloned context. The cloned context could be used with the CSSM_DigestDataUpdate and CSSM_DigestDataFinal functions.

SEE ALSO

CSSM_DigestData, CSSM_DigestDataInit,
CSSM_DigestDataUpdate, CSSM_DigestDataFinal

Why not acquire a nicely bound hard copy?
Click here to return to the publication details or order a copy of this publication.
You should also read the legal notice explaining the terms and conditions relating to the CDSA documentation.

Contents Next section Index