PropVariantToInt64WithDefault 関数 (propvarutil.h)
PROPVARIANT 構造体の Int64 プロパティ値を抽出します。 値が存在しない場合は、指定された既定値が返されます。
構文
PSSTDAPI_(LONGLONG) PropVariantToInt64WithDefault(
[in] REFPROPVARIANT propvarIn,
[in] LONGLONG llDefault
);
パラメーター
[in] propvarIn
型: REFPROPVARIANT
ソース PROPVARIANT 構造体への参照。
[in] llDefault
種類: LONGLONG
現在値が存在しない場合に使用する既定のプロパティ値を指定します。
戻り値
種類: LONGLONG
抽出された LONGLONG 値 (既定値) を返します。
解説
このヘルパー関数は、呼び出し元のアプリケーションが PROPVARIANT が LONGLONG 値を保持することを想定し、保持しない場合は既定値を使用する場所で使用されます。 たとえば、プロパティ ストアから値を取得するアプリケーションでは、これを使用して Int64 プロパティの LONGLONG 値を安全に抽出できます。
ソース PROPVARIANT に 型VT_I8がある場合、このヘルパー関数は LONGLONG 値を抽出します。 それ以外の場合は、 PROPVARIANT 構造体の値を LONGLONG に変換しようとします。 ソース PROPVARIANT に 型VT_EMPTY がある場合、または変換できない場合、 PropVariantToInt64WithDefault は llDefault によって提供される既定値を返します。 可能な変換の一覧については、「 PropVariantChangeType 」を参照してください。
例
次の例は、より大きなプログラムの一部として含めるために、PropVariantToInt64WithDefault を使用して PROPVARIANT 内の LONGLONG 値にアクセスする方法を示しています。
// PROPVARIANT propvar;
// Assume the variable propvar is initialized and valid
// The application is expecting propvar to hold a VT_I8 value, but wishes to treat VT_EMPTY as -1.
LONGLONG llValue = PropVariantToInt64WithDefault(propvar, -1);
// llValue is valid
要件
サポートされている最小のクライアント | WINDOWS XP と SP2、Windows Vista [デスクトップ アプリのみ] |
サポートされている最小のサーバー | Windows Server 2003 SP1 [デスクトップ アプリのみ] |
対象プラットフォーム | Windows |
ヘッダー | propvarutil.h |
Library | Propsys.lib |
[DLL] | Propsys.dll (バージョン 6.0 以降) |
再頒布可能パッケージ | Windows デスクトップ検索 (WDS) 3.0 |