NAME    [Toc]    [Back]

       QuerySize, CSSM_QuerySize, CSP_QuerySize - Get size of the
       output data (CDSA)

SYNOPSIS    [Toc]    [Back]

       # include <cdsa/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    [Toc]    [Back]

       Common Security Services Manager library (libcssm.so)

API PARAMETERS    [Toc]    [Back]

       The handle for an encryption and  decryption  context.   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.  The number  of  entries  in  the
       array  of  DataBlockSizes.   An  array of data block input
       sizes and corresponding entries for the data block  output
       sizes that are returned by this function.

SPI PARAMETERS    [Toc]    [Back]

       The handle that describes the add-in cryptographic service
       provider module used to perform calls to CSSM for the memory
  functions  managed  by CSSM.  Pointer to CSSM_CONTEXT
       structure that describes the attributes with this context.

DESCRIPTION    [Toc]    [Back]

       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    [Toc]    [Back]

       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    [Toc]    [Back]

       Errors are described in the CDSA technical standard.   See
       CDSA_intro(3).  CSSMERR_CSP_QUERY_SIZE_UNKNOWN

SEE ALSO    [Toc]    [Back]

       Books

       Intel    CDSA    Application    Developer's   Guide   (see
       CDSA_intro(3))

       Reference Pages    [Toc]    [Back]

       Functions for the CSSM API:

       CSSM_EncryptData(3),            CSSM_EncryptDataUpdate(3),
       CSSM_DecryptData(3), CSSM_DecryptDataUpdate(3), CSSM_SignData(3), CSSM_VerifyData(3), CSSM_DigestData(3), CSSM_GenerateMac(3)

       Functions for the CSP SPI:

       CSP_EncryptData(3), CSP_EncryptDataUpdate(3), CSP_DecryptData(3),    CSP_DecryptDataUpdate(3),     CSP_SignData(3),
       CSP_VerifyData(3), CSP_DigestData(3), CSP_GenerateMac(3)



                                                     QuerySize(3)