共用方式為


(propvarutil.h) InitPropVariantFromBoolean 函式

使用指定的布爾值,將指定的 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_TRUEVARIANT_FALSE。 直接使用此結構成員時,請使用這些常數,而不是 TRUE 或 FALSE,因為VARIANT_TRUE不等於 TRUE,VARIANT_TRUE) ) 與 size (of (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

另請參閱

InitPropVariantFromBooleanVector

InitVariantFromBoolean

PropVariantToBoolean