PropVariantToUInt64VectorAlloc 関数 (propvarutil.h)

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

構文

PSSTDAPI PropVariantToUInt64VectorAlloc(
  [in]  REFPROPVARIANT propvar,
  [out] ULONGLONG      **pprgn,
  [out] ULONG          *pcElem
);

パラメーター

[in] propvar

型: REFPROPVARIANT

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

[out] pprgn

種類: ULONGLONG**

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

[out] pcElem

種類: ULONG*

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

戻り値

種類: HRESULT

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

リターン コード 説明
S_OK
成功した場合 はS_OK を返し、それ以外の場合はエラー値を返します。
E_INVALIDARG
PROPVARIANT が適切な型ではありません。

注釈

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

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

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

// PROPVARIANT propvar;
// Assume the variable propvar is initialized and valid. The application is expecting propvar to contain a vector of ULONGLONG values.
ULONGLONG *prgLongs;
ULONG cElems;
HRESULT hr = PropVariantToUInt64VectorAlloc(propvar, &prgLongs, &cElems);
if (SUCCEEDED(hr))
{
     // prgLongs now points to a vector of cElems ULONGLONGs.
     CoTaskMemFree(prgLongs);
}

要件

要件
サポートされている最小のクライアント WINDOWS XP と SP2、Windows Vista [デスクトップ アプリのみ]
サポートされている最小のサーバー Windows Server 2003 SP1 [デスクトップ アプリのみ]
対象プラットフォーム Windows
ヘッダー propvarutil.h
Library Propsys.lib
[DLL] Propsys.dll (バージョン 6.0 以降)
再頒布可能パッケージ Windows デスクトップ検索 (WDS) 3.0

こちらもご覧ください

InitPropVariantFromUInt64Vector

PropVariantGetUInt64Elem

PropVariantToUInt64

PropVariantToUInt64Vector

VariantToUInt64Array