PropVariantToUInt64Vector 関数 (propvarutil.h)

PROPVARIANT 構造体から ULONGLONG ベクターにデータを抽出します。

構文

PSSTDAPI PropVariantToUInt64Vector(
  [in]  REFPROPVARIANT propvar,
  [out] ULONGLONG      *prgn,
  [in]  ULONG          crgn,
  [out] ULONG          *pcElem
);

パラメーター

[in] propvar

型: REFPROPVARIANT

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

[out] prgn

種類: ULONGLONG*

crgnULONGLONG 値を含むバッファーを指します。 この関数が戻ると、ソース PROPVARIANT から抽出された pcElemULONGLONG 要素を使用してバッファーが初期化されます。

[in] crgn

種類: ULONG

prgn が指すバッファーのサイズ (要素単位)。

[out] pcElem

種類: ULONG*

この関数から戻るときに、ソース PROPVARIANT 構造体から抽出された ULONGLONG 値の数が格納されます。

戻り値

型: HRESULT

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

注釈

このヘルパー関数は、呼び出し元のアプリケーションが、固定数の要素を持つ ULONGLONG 値のベクターを保持する PROPVARIANT を想定している場所で使用されます。

ソース PROPVARIANT の型 が VT_UI8 または | VT_ARRAY VT_UI8VT_VECTOR | 場合、このヘルパー関数は最大 crgnULONGLONG 値を抽出し、 prgn が指すバッファーに配置します。 PROPVARIANT に prgn バッファーに収まるより多くの要素が含まれている場合、この関数はエラーを返し、pcElem を 0 に設定します。

例

次の例は、より大きなプログラムの一部として含めるために、PropVariantToUInt64Vector を使用して PROPVARIANT 内の ULONGLONG ベクター値にアクセスする方法を示しています。

// PROPVARIANT propvar;
// Assume the variable propvar is initialized and valid
ULONGLONG rgLongs[4]; // The application is expecting propvar to hold 4 ULONGLONGs in a vector
ULONG cElems;
HRESULT hr = PropVariantToUInt64Vector(propvar, rgLongs, ARRAYSIZE(rgLongs), &cElems);
if (SUCCEEDED(hr))
{
     if (cElems == ARRAYSIZE(rgLongs))
     {
         // The application got 4 ULONGLONGs which are now stored in rgLongs
     }
     else
     {
         // The application got cElems which are stored in the first cElems elements of rgLongs
     }
}

要件

こちらもご覧ください

InitPropVariantFromUInt64Vector

PropVariantGetUInt64Elem

PropVariantToUInt64

PropVariantToUInt64VectorAlloc

VariantToUInt64Array