VariantGetStringElem function (propvarutil.h)

Extracts a single wide string element from a variant structure.

Syntax

PSSTDAPI VariantGetStringElem(
  [in]  REFVARIANT var,
  [in]  ULONG      iElem,
  [out] PWSTR      *ppszVal
);

Parameters

[in] var

Type: REFVARIANT

Reference to a source variant structure.

[in] iElem

Type: ULONG

Specifies a vector or array index; otherwise, value must be 0.

[out] ppszVal

Type: PWSTR*

The address of a pointer to the extracted element value.

Return value

Type: HRESULT

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

Requirements