IDataConvert::GetConversionSize

  • Article

Calculates the size of the buffer needed by the destination data type to support a conversion.

Syntax

HRESULT GetConversionSize (
   DBTYPE       wSrcType,
   DBTYPE       wDstType,
   DBLENGTH *   pcbSrcLength,
   DBLENGTH *   pcbDstLength,
   void *       pSrc);

Parameters

  • wSrcType
    [in] The source type of the data.

  • wDstType
    [in] The destination type of the data.

  • pcbSrcLength
    [in] A pointer to the length of the source data, in bytes. This value can be a null pointer.

  • pcbDstLength
    [out] A pointer to memory in which to return the size of the destination buffer required for the conversion, in bytes.

  • pSrc
    [in] A pointer to the source data.

Return Code

  • S_OK
    The method succeeded.

  • E_FAIL
    A provider-specific error occurred.

  • E_INVALIDARG
    pcbDstLength was a null pointer, or the information supplied by the consumer was insufficient to determine the appropriate buffer size.

    pcbSrcLength was a null pointer, and the conversion size was requested for a conversion from a variable-length data type to DBTYPE_STR, DBTYPE_WSTR, DBTYPE_BSTR, or DBTYPE_VARIANT.

  • DB_E_UNSUPPORTEDCONVERSION
    The requested conversion was not supported.

Comments

The size of a fixed-width destination type can be discovered by passing a null pointer in the pSrc parameter. For example, the width of wType can be determined by adding the following code:

pConvert->GetConversionSize(wType, wType, 0, &ulWidth, 0);