共用方式為

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。

十進位值 意義
2
INSTALLSTATE_ADVERTISED
 此功能可以公告。
4
INSTALLSTATE_ABSENT
 此功能可能不存在。
8
INSTALLSTATE_LOCAL
 此功能可以安裝在本機磁碟驅動器上。
16
INSTALLSTATE_SOURCE
 此功能可設定為從來源、CD-ROM 或網路執行。
32
INSTALLSTATE_DEFAULT
 此功能可以設定為使用預設位置：本機或來源。

傳回值

MsiGetFeatureValidStates 函式會傳回下列值：

言論

請參閱從程式呼叫資料庫函式 。

MsiGetFeatureValidStates 函式會藉由查詢連結至指定功能的所有元件，而不考慮任何元件的目前安裝狀態，來判斷狀態有效性。

功能可能的有效狀態取決於如下：

  • 如果功能不包含元件，則INSTALLSTATE_LOCAL和INSTALLSTATE_SOURCE都是功能的有效狀態。
  • 如果功能至少有一個元件具有 msidbComponentAttributesLocalOnly 或 msidbComponentAttributesOptional 的屬性，則INSTALLSTATE_LOCAL是功能的有效狀態。
  • 如果功能至少有一個元件具有 msidbComponentAttributesSourceOnly 或 msidbComponentAttributesOptional 的屬性，則INSTALLSTATE_SOURCE是功能的有效狀態。
  • 如果屬於功能的元件檔案已修補或來自壓縮來源，則INSTALLSTATE_SOURCE不包含為功能的有效狀態。
  • 如果功能不允許廣告（msidbFeatureAttributesDisallowAdvertise）或功能需要平臺支持廣告（msidbFeatureAttributesNoUnsupportedAdvertise），且平臺不支援它，則INSTALLSTATE_ADVERTISE不是有效的狀態。
  • 如果功能的屬性不包含 msidbFeatureAttributesUIDisallowAbsent，則INSTALLSTATE_ABSENT是此功能的有效狀態。
  • 標示為遵循父功能之子功能的有效狀態（msidbFeatureAttributesFollowParent）是以父功能的動作或已安裝狀態為基礎。
呼叫 MsiGetFeatureValidStates 條件語句之後，就可以用來測試功能的有效安裝狀態。 例如，下列 MsiGetFeatureValidStates 的呼叫 會取得 Feature1 的安裝狀態。 
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 標頭會根據 UNICODE 預處理器常數的定義，將 MsiGetFeatureValidStates 定義為自動選取此函式的 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
目標平臺 窗戶
標頭 msiquery.h
連結庫 Msi.lib
DLL Msi.dll

另請參閱

安裝程式選取函式

傳遞 Null 做為 Windows Installer 函式的自變數