|
VMS Help CDSA, CDSA_API, QuerySize *Conan The Librarian |
NAME
QuerySize,
CSSM_QuerySize,
CSP_QuerySize - Get size of the output data (CDSA)
SYNOPSIS
# include <cssm.h>
API:
CSSM_RETURN CSSMAPI CSSM_QuerySize
(CSSM_CC_HANDLE CCHandle,
CSSM_BOOL Encrypt,
uint32 QuerySizeCount,
CSSM_QUERY_SIZE_DATA_PTR DataBlockSizes)
SPI:
CSSM_RETURN CSSMCSPI CSP_QuerySize
(CSSM_CSP_HANDLE CSPHandle,
CSSM_CC_HANDLE CCHandle,
const CSSM_CONTEXT *Context,
CSSM_BOOL Encrypt,
uint32 QuerySizeCount,
CSSM_QUERY_SIZE_DATA_PTR DataBlockSizes)
LIBRARY
Common Security Services Manager library (CDSA$INCSSM300_SHR.EXE)
API PARAMETERS
CCHandle (input)
The handle for an encryption and decryption context.
Encrypt (input)
A boolean indicating whether encryption is the operation for
which the output data size should be calculated. If CSSM_TRUE,
the operation is encryption. If CSSM_FALSE the operation is
decryption.
QuerySizeCount (input)
The number of entries in the array of DataBlockSizes.
DataBlockSizes (input/output)
An array of data block input sizes and corresponding entries
for the data block output sizes that are returned by this
function.
SPI PARAMETERS
CSPHandle (input)
The handle that describes the add-in cryptographic service
provider module used to perform calls to CSSM for the memory
functions managed by CSSM.
Context (input)
Pointer to CSSM_CONTEXT structure that describes the attributes
with this context.
DESCRIPTION
This function queries for the size of the output data for a
cryptographic operation. If the context is an encryption or
decryption context type then the Encrypt parameter will determine
which operation is being performed. If Encrypt is set to CSSM_TRUE
then it is an encrypt operation, otherwise it is a decrypt operation.
For all other context types the Encrypt parameter is ignored. This
function can also be used to query the output size requirements for
the intermediate steps of a staged cryptographic operation. There
may be algorithm-specific and token-specific rules restricting the
lengths of data following data update calls.
RETURN VALUE
A CSSM_RETURN value indicating success or specifying a particular
error condition. The value CSSM_OK indicates success. All other
values represent an error condition.
ERRORS
Errors are described in the CDSA technical standard. See CDSA.
CSSMERR_CSP_QUERY_SIZE_UNKNOWN
SEE ALSO
Books
Intel CDSA Application Developer's Guide (see CDSA)
Other Help Topics
Functions for the CSSM API:
CSSM_EncryptData
CSSM_EncryptDataUpdate
CSSM_DecryptData
CSSM_DecryptDataUpdate
CSSM_SignData
CSSM_VerifyData
CSSM_DigestData
CSSM_GenerateMac
Functions for the CSP SPI:
CSP_EncryptData
CSP_EncryptDataUpdate
CSP_DecryptData
CSP_DecryptDataUpdate
CSP_SignData
CSP_VerifyData
CSP_DigestData
CSP_GenerateMac
|
|