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不包含為功能的有效狀態。
  • INSTALLSTATE_ADVERTISE如果功能不允許 (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 標頭會將 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

另請參閱

安裝程式選取函式

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