PropVariantToUInt16VectorAlloc 関数 (propvarutil.h)

PROPVARIANT 構造体から、新しく割り当てられた符号なしショート ベクターにデータを抽出します。

構文

PSSTDAPI PropVariantToUInt16VectorAlloc(
  [in]  REFPROPVARIANT propvar,
  [out] USHORT         **pprgn,
  [out] ULONG          *pcElem
);

パラメーター

[in] propvar

型: REFPROPVARIANT

ソース PROPVARIANT 構造体への参照。

[out] pprgn

種類: USHORT**

この関数が戻るとき、 には、ソース PROPVARIANT 構造体から抽出された符号なし短い値のベクターへのポインターが含まれます。

[out] pcElem

種類: ULONG*

この関数が戻るとき、 には、ソース PROPVARIANT 構造体から抽出された符号なし短い値の数が含まれます。

戻り値

種類: HRESULT

この関数は、これらの値のいずれかを返すことができます。

注釈

このヘルパー関数は、呼び出し元のアプリケーションが PROPVARIANT が 符号なし短い 値のベクトルを保持することを想定している場所で使用されます。

ソース PROPVARIANT の型が VT_UI2 または VT_ARRAY | VT_UI2VT_VECTOR | 場合、この関数は符号なし短い値のベクトルを新しく割り当てられたベクターに抽出します。 呼び出し元のアプリケーションは、 CoTaskMemFree を使用して 、pprgn が指すベクトルが不要になったときに解放する役割を担います。

例

次の例は、より大きなプログラムの一部として含まれるように、PropVariantToUInt16VectorAlloc を使用して PROPVARIANT の符号なし短いベクトル値にアクセスする方法を示しています。

// PROPVARIANT propvar;
// Assume the variable propvar is initialized and valid. The application is expecting propvar to contain a vector of <dtype rid="ushort"/> values.
USHORT *prgShorts;
ULONG cElems;
HRESULT hr = PropVariantToUInt16VectorAlloc(propvar, & prgShorts, &cElems);
if (SUCCEEDED(hr))
{
     // prgShorts now points to a vector of cElems USHORTs.
     CoTaskMemFree(prgShorts);
}

要件

こちらもご覧ください

InitPropVariantFromUInt16Vector

PropVariantGetUInt16Elem

PropVariantToUInt16

PropVariantToUInt16Vector

VariantToUInt16Array