PropVariantToVariant function (propvarutil.h)

Converts the contents of a PROPVARIANT structure to a VARIANT structure.

Syntax

PSSTDAPI PropVariantToVariant(
  [in]  const PROPVARIANT *pPropVar,
  [out] VARIANT           *pVar
);

Parameters

[in] pPropVar

Type: const PROPVARIANT*

Pointer to a source PROPVARIANT structure.

[out] pVar

Type: VARIANT*

Pointer to a VARIANT structure. When this function returns, the VARIANT contains the converted information.

Return value

Type: HRESULT

If this function succeeds, it returns S_OK. Otherwise, it returns an HRESULT error code.

Remarks

Normally, the data stored in the PROPVARIANT is copied to the VARIANT without a datatype change. However, in the following cases, there is no direct VARIANT support for the datatype, and they are converted as shown.

The following types cannot be converted with this function.

• VT_STORAGE
• VT_BLOB_OBJECT
• VT_STREAMED_OBJECT
• VT_STORED_OBJECT
• VT_CF
• VT_VECTOR | VT_CF

Requirements