InitPropVariantFromBoolean 関数 (propvarutil.h)
指定したブール値を使用して、特定の PROPVARIANT 構造体を VT_BOOL として初期化します。
構文
HRESULT InitPropVariantFromBoolean(
[in] BOOL fVal,
[out] PROPVARIANT *ppropvar
);
パラメーター
[in] fVal
種類: BOOL
ソース BOOL 値。
[out] ppropvar
型: PROPVARIANT*
この関数が戻るときに、 には初期化された PROPVARIANT 構造体が 含まれます。
戻り値
型: HRESULT
この関数が成功すると、 S_OKが返されます。 そうでない場合は、HRESULT エラー コードを返します。
注釈
これはインライン関数であり、そのソース コードは ヘッダーに用意されています。 .dll または .lib ファイルには含まれません。
この関数によって明示的に初期化される boolVal メンバーは 型VARIANT_BOOL であるため、値 をVARIANT_TRUE または VARIANT_FALSEできます。 この構造体メンバーを直接操作する場合は、 TRUE または FALSE の代わりにこれらの定数を使用 します。これは、VARIANT_TRUE が TRUE と等しくなく、sizeof(VARIANT_TRUE) が sizeof(TRUE) と同じではないのでです。
例
次の例は、より大きなプログラムの一部として含めるために、 InitPropVariantFromBoolean の使用方法を示しています。
PROPVARIANT propvar;
HRESULT hr = InitPropVariantFromBoolean(TRUE, &propvar);
if (SUCCEEDED(hr))
{
// propvar now is valid and has type VT_BOOL.
PropVariantClear(&propvar);
}
要件
| 要件 | 値 |
|---|---|
| サポートされている最小のクライアント | WINDOWS XP と SP2、Windows Vista [デスクトップ アプリのみ] |
| サポートされている最小のサーバー | Windows Server 2003 SP1 [デスクトップ アプリのみ] |
| 対象プラットフォーム | Windows |
| ヘッダー | propvarutil.h |
| 再頒布可能パッケージ | Windows デスクトップ検索 (WDS) 3.0 |