PropVariantToFileTimeVectorAlloc 関数 (propvarutil.h)

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

構文

PSSTDAPI PropVariantToFileTimeVectorAlloc(
  [in]  REFPROPVARIANT propvar,
  [out] FILETIME       **pprgft,
  [out] ULONG          *pcElem
);

パラメーター

[in] propvar

型: REFPROPVARIANT

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

[out] pprgft

種類: FILETIME**

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

[out] pcElem

種類: ULONG*

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

戻り値

型: HRESULT

次のいずれかの値を返します。

注釈

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

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

出力 FILETIMEs は、ソース FILETIMEs と同じタイム ゾーンを使用します。

例

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

// PROPVARIANT propvar;
// Assume the variable propvar is initialized and valid. 
// The application is expecting propvar to contain a vector of FILETIME values.
BOOL *prgTimes;
ULONG cTimes;
HRESULT hr = PropVariantToBooleanVectorAlloc(propvar, &prgTimes, &cTimes);
if (SUCCEEDED(hr))
{
     // prgTimes now points to a vector of cTimes file times.
     CoTaskMemFree(prgTimes);
}

要件

こちらもご覧ください

InitPropVariantFromFileTimeVector

PropVariantToFileTime

PropVariantToFileTimeVector