VariantToPropVariant function (propvarutil.h)

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

Syntax

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

Parameters

[in] pVar

Type: const VARIANT*

Pointer to a source VARIANT structure.

[out] pPropVar

Type: PROPVARIANT*

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

Return value

Type: HRESULT

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

Remarks

The following cannot be handled by this function.

  • VT_BYREF | VT_DATE
  • VT_BYREF | VT_BSTR
  • VT_BYREF | VT_UNKNOWN

Requirements

Requirement Value
Minimum supported client Windows Vista, Windows XP with SP2 [desktop apps only]
Minimum supported server Windows Server 2003 with SP1 [desktop apps only]
Target Platform Windows
Header propvarutil.h
Library Propsys.lib
DLL Propsys.dll (version 6.0 or later)
Redistributable Windows Desktop Search (WDS) 3.0