共用方式為

MsiGetFeatureInfoA 函式 （msi.h）

  • 發行項

MsiGetFeatureInfo 函式會傳回功能的描述性資訊。

語法

UINT MsiGetFeatureInfoA(
  [in]                MSIHANDLE hProduct,
  [in]                LPCSTR    szFeature,
  [out, optional]     LPDWORD   lpAttributes,
  [out, optional]     LPSTR     lpTitleBuf,
  [in, out, optional] LPDWORD   pcchTitleBuf,
  [out, optional]     LPSTR     lpHelpBuf,
  [in, out, optional] LPDWORD   pcchHelpBuf
);

參數

[in] hProduct

擁有此功能的產品句柄。 此句柄是從 MsiOpenProduct取得。

[in] szFeature

要傳回哪些資訊之功能的功能程序代碼。

[out, optional] lpAttributes

包含下列一或多個屬性旗標的位置指標。

INSTALLFEATUREATTRIBUTE_FAVORLOCAL （1）

INSTALLFEATUREATTRIBUTE_FAVORSOURCE （2）

INSTALLFEATUREATTRIBUTE_FOLLOWPARENT （4）

INSTALLFEATUREATTRIBUTE_FAVORADVERTISE （8）

INSTALLFEATUREATTRIBUTE_DISALLOWADVERTISE （16）

INSTALLFEATUREATTRIBUTE_NOUNSUPPORTEDADVERTISE （32）

如需詳細資訊，請參閱
功能資料表。 MsiGetFeatureInfo 傳回的值是功能數據表 [屬性] 資料行中的值兩倍。

[out, optional] lpTitleBuf

要接收功能本地化名稱之緩衝區的指標，其對應至 [功能數據表] 中的 [標題] 字段，。

這個參數是選擇性的，而且可以是 Null。

[in, out, optional] pcchTitleBuf

輸入時，lpTitleBuf 的大小。 輸出時，lpTitleBuf 中傳回的字元數。 在輸入時，這是緩衝區的完整大小，並包含終止 Null 字元的空間。 如果傳入的緩衝區太小，則傳回的計數不包含終止的 Null 字元。

[out, optional] lpHelpBuf

接收功能當地語系化描述之緩衝區的指標，其會對應至功能數據表中 功能的描述字段，。 這個參數是選擇性的，而且可以是 Null。

[in, out, optional] pcchHelpBuf

輸入時，lpHelpBuf 的大小。 輸出時，lpHelpBuf 中傳回的字元數。 在輸入時，這是緩衝區的完整大小，並包含終止 Null 字元的空間。 如果傳入的緩衝區太小，則傳回的計數不包含終止的 Null 字元。

傳回值

傳回碼 描述
ERROR_INVALID_HANDLE
 產品句柄無效。
ERROR_INVALID_PARAMETER
 其中一個參數無效。
ERROR_MORE_DATA
 緩衝區太小，無法保存要求的數據。
ERROR_SUCCESS
 函式會成功傳回。
ERROR_UNKNOWN_FEATURE
 目前還不清楚此功能。

言論

MsiGetFeatureInfo 函式的緩衝區大小應包含終止 Null 字元的額外字元。 如果緩衝區太小，則傳回的字串會以 Null 截斷，而緩衝區大小包含整個字串中的字元數，不包括終止的 Null 字元。 如需詳細資訊，請參閱 從程式呼叫資料庫函式。

注意

msi.h 標頭會根據 UNICODE 預處理器常數的定義，將 MsiGetFeatureInfo 定義為自動選取此函式的 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 Installer 版本所需的最低 Windows Service Pack 相關信息，請參閱 Windows Installer Run-Time 需求。
目標平臺 窗戶
標頭 msi.h
連結庫 Msi.lib
DLL Msi.dll

另請參閱

產品查詢函式