PropVariantToFileTimeVector 関数 (propvarutil.h)

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

構文

PSSTDAPI PropVariantToFileTimeVector(
  [in]  REFPROPVARIANT propvar,
  [out] FILETIME       *prgft,
  [in]  ULONG          crgft,
  [out] ULONG          *pcElem
);

パラメーター

[in] propvar

型: REFPROPVARIANT

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

[out] prgft

種類: FILETIME*

crgft FILETIME 値を含むバッファーを指します。 この関数が戻ると、バッファーはソース PROPVARIANT 構造体から抽出された pcElem FILETIME 要素で初期化されています。

[in] crgft

種類: ULONG

prgft が指すバッファーの要素のサイズ。

[out] pcElem

種類: ULONG*

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

戻り値

種類: HRESULT

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

リターン コード	説明
S_OK	成功した場合 はS_OK を返し、それ以外の場合はエラー値を返します。
TYPE_E_BUFFERTOOSMALL	ソース PROPVARIANT には crgn 値を超える値が含まれていました。 prgft が指すバッファー。
E_INVALIDARG	PROPVARIANT が適切な型ではありません。

注釈

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

ソース PROPVARIANT の型が VT_VECTOR の場合 |VT_FILETIME、このヘルパー関数は crgft FILETIME 値まで抽出し、 prgft が指すバッファーに配置します。 PROPVARIANT に prgft バッファーに収まるより多くの要素が含まれている場合、この関数はエラーを返し、pcElem を 0 に設定します。

出力 FILETIMEs では、ソース FILETIMEs と同じタイム ゾーンが使用されます。

例

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

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

要件

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

こちらもご覧ください

InitPropVariantFromFileTimeVector

PropVariantToFileTime

PropVariantToFileTimeVectorAlloc