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