msiGetFeatureValidStatesA 函式 (msiquery.h)
MsiGetFeatureValidStates 函式會傳回有效的安裝狀態。
語法
UINT MsiGetFeatureValidStatesA(
[in] MSIHANDLE hInstall,
[in] LPCSTR szFeature,
[out] LPDWORD lpInstallStates
);
參數
[in] hInstall
處理提供給 DLL 自定義動作的安裝,或透過 MsiOpenPackage、 MsiOpenPackageEx 或 MsiOpenProduct 取得。
[in] szFeature
指定功能名稱。
[out] lpInstallStates
接收保存有效安裝狀態的位置。 針對每個有效的安裝狀態,安裝程式會將 pInstallState 設定為下列值的組合。 此參數不得為 null。
傳回值
MsiGetFeatureValidStates 函式會傳回下列值:
備註
請參閱 從程式呼叫資料庫函式。
MsiGetFeatureValidStates 函式會藉由查詢連結至指定功能的所有元件來判斷狀態有效性,而不考慮任何元件的目前安裝狀態。
功能可能的有效狀態會依下列方式決定:
- 如果此功能不包含元件,則INSTALLSTATE_LOCAL和INSTALLSTATE_SOURCE都是功能的有效狀態。
- 如果功能至少有一個元件具有 msidbComponentAttributesLocalOnly 或 msidbComponentAttributesOptional 的屬性,INSTALLSTATE_LOCAL是功能的有效狀態。
- 如果功能至少有一個元件具有 msidbComponentAttributesSourceOnly 或 msidbComponentAttributesOptional 的屬性,INSTALLSTATE_SOURCE是功能的有效狀態。
- 如果屬於功能的元件檔案已修補或來自壓縮來源,則INSTALLSTATE_SOURCE不包含為功能的有效狀態。
- INSTALLSTATE_ADVERTISE如果功能不允許 (msidbFeatureAttributesDisallowAdvertise) ,或此功能需要 (msidbFeatureAttributesNoUnsupportedAdvertise) ,而平臺不支援它,則INSTALLSTATE_ADVERTISE不是有效的狀態。
- 如果功能的屬性不包含 msidbFeatureAttributesUIDisallowAbsent,則INSTALLSTATE_ABSENT是功能的有效狀態。
- 標示為遵循父功能的有效狀態 (msidbFeatureAttributesFollowParent) 是以父功能的動作或安裝狀態為基礎。
MsiGetFeatureValidStates(hProduct, "Feature1", &dwValidStates);
如果 Feature1 具有值為 0 的屬性 (偏好本機) ,而 Feature1 有一個元件,其值為 0 (local 僅) ,則呼叫之後的 dwValidStates 值為 14。 這表示 INSTALLSTATE_LOCAL、INSTALLSTATE_ABSENT 和 INSTALLSTATE_ADVERTISED 是Feature1的有效狀態。 如果local是此功能的有效狀態,下列條件語句會評估為True。
( ( dwValidStates & ( 1 INSTALLSTATE_LOCAL ) ) == ( 1 <<<< INSTALLSTATE_LOCAL ) )
如果函式失敗,您可以使用 MsiGetLastErrorRecord 來取得擴充的錯誤資訊。
注意
msiquery.h 標頭會將 MsiGetFeatureValidStates 定義為別名,根據 UNICODE 預處理器常數的定義,自動選取此函式的 ANSI 或 Unicode 版本。 混合使用編碼中性別名與非編碼中性的程序代碼,可能會導致編譯或運行時間錯誤不符。 如需詳細資訊,請參閱 函式原型的慣例。
規格需求
需求 | 值 |
---|---|
最低支援的用戶端 | Windows Server 2012、Windows 8、Windows Server 2008 R2 或 Windows 7 上的 Windows Installer 5.0。 Windows Server 2008 或 Windows Vista 上的 Windows Installer 4.0 或 Windows Installer 4.5。 Windows Server 2003 或 Windows XP 上的 Windows Installer |
目標平台 | Windows |
標頭 | msiquery.h |
程式庫 | Msi.lib |
Dll | Msi.dll |