skip book previous and next navigation links
go up to top of book: HP Open Source Security for OpenVMS Volume 1:... HP Open Source Security for OpenVMS Volume 1:...
go to beginning of reference: API FunctionsAPI Functions
go to previous page: QueryKeySizeInBitsQueryKeySizeInBits
go to next page: RetrieveCounterRetrieveCounter
end of book navigation links


QuerySize
Library
Spi Parameters
Return Value
See Also
 Api Parameters
Description
Errors

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)


return to top LIBRARY  

Common Security Services Manager library (cdsa$incssm300_shr.exe)


return to top API PARAMETERS  

CCHandle (input)
 The handle for an encryption and decryption context.
Encrypt (input)
 A boolean indicating whether encryption is the operationfor 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 correspondingentries for the data block output sizes that are returned by thisfunction.


return to top SPI PARAMETERS  

CSPHandle (input)
 The handle that describes the add-in CryptographicService Provider module used to perform calls to CSSM for the memoryfunctions managed by CSSM.
Context (input)
 Pointer to CSSM_CONTEXT structure that describesthe attributes with this context.


return to top DESCRIPTION  

This function queries for the size of the output data fora cryptographic operation. If the context is an encryption or decryptioncontext type then the Encrypt parameter willdetermine which operation is being performed. If Encrypt isset to CSSM_TRUE then it is an encrypt operation, otherwise it isa decrypt operation. For all other context types the Encrypt parameteris ignored. This function can also be used to query the output sizerequirements for the intermediate steps of a staged cryptographicoperation. There may be algorithm-specific and token-specific rulesrestricting the lengths of data following data update calls.


return to top RETURN VALUE  

A CSSM_RETURN value indicating success or specifying a particularerror condition. The value CSSM_OK indicates success. All othervalues represent an error condition.


return to top ERRORS  

Errors are described in the CDSA Technical Standard.
CSSMERR_CSP_QUERY_SIZE_UNKNOWN


return to top SEE ALSO  

Books

Intel CDSA Application Developer's Guide

Online Help

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


go to previous page: QueryKeySizeInBitsQueryKeySizeInBits
go to next page: RetrieveCounterRetrieveCounter