PropVariantToInt64VectorAlloc 関数 (propvarutil.h)
PROPVARIANT 構造体から新しく割り当てられた LONGLONG ベクターにデータを抽出します。
構文
PSSTDAPI PropVariantToInt64VectorAlloc(
[in] REFPROPVARIANT propvar,
[out] LONGLONG **pprgn,
[out] ULONG *pcElem
);
パラメーター
[in] propvar
型: REFPROPVARIANT
ソース PROPVARIANT 構造体への参照。
[out] pprgn
種類: LONGLONG**
この関数が戻るとき、 には、ソース PROPVARIANT 構造体から抽出された LONGLONG 値のベクターへのポインターが含まれます。
[out] pcElem
種類: ULONG*
この関数が戻るとき、 には、ソース PROPVARIANT 構造体から抽出された LONGLONG 値の数が格納されます。
戻り値
種類: HRESULT
この関数は、これらの値のいずれかを返すことができます。
| リターン コード | 説明 |
|---|---|
|
成功した場合 はS_OK を返し、それ以外の場合はエラー値を返します。 |
|
PROPVARIANT が適切な型ではありません。 |
解説
このヘルパー関数は、呼び出し元のアプリケーションが、LONGLONG 値のベクターを保持する PROPVARIANT を想定している場所で使用されます。
ソース PROPVARIANT の型が VT_I8 または VT_ARRAY | VT_I8VT_VECTOR | 場合、この関数は LONGLONG 値のベクターを新しく割り当てられたベクターに抽出します。 呼び出し元のアプリケーションは、 CoTaskMemFree を使用して 、pprgn が指すベクトルが不要になったときに解放する役割を担います。
例
大きなプログラムの一部として含める次の例では、PropVariantToInt64VectorAlloc を使用して PROPVARIANT 内の LONGLONG ベクター値にアクセスする方法を示します。
// PROPVARIANT propvar;
// Assume the variable propvar is initialized and valid. The application is expecting propvar to contain a vector of LONGLONG values.
LONGLONG *prgLongs;
ULONG cElems;
HRESULT hr = PropVariantToInt64VectorAlloc(propvar, &prgLongs, &cElems);
if (SUCCEEDED(hr))
{
// prgLongs now points to a vector of cElems LONGLONGs.
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 |