MsiViewGetColumnInfo 函式 (msiquery.h)

MsiViewGetColumnInfo 函式會傳回包含數據行名稱或定義的記錄。 此函式會傳回應該使用 MsiCloseHandle 關閉的句柄。

語法

UINT MsiViewGetColumnInfo(
  [in]  MSIHANDLE  hView,
  [in]  MSICOLINFO eColumnInfo,
  [out] MSIHANDLE  *phRecord
);

參數

[in] hView

處理要從中取得數據行資訊的檢視。

[in] eColumnInfo

指定旗標,指出需要何種類型的資訊。 此參數必須是下列其中一個值。

意義
MSICOLINFO_NAMES
會傳回數據行名稱。
MSICOLINFO_TYPES
會傳回定義。

[out] phRecord

接收數據行信息數據記錄之句柄的指標。

傳回值

請注意,在記憶體不足的情況下,此函式可能會引發STATUS_NO_MEMORY例外狀況。

備註

MsiViewGetColumnInfo 所傳回的數據行描述是以數據行定義格式一節中所述的格式。 每個數據行都會由對應記錄欄位中的字串描述。 定義字串是由單一字母所組成,代表數據類型,後面接著在字元中 (的寬度,否則為位元組) 。 零的寬度會指定未系結的寬度 (例如長文字欄位和數據流) 。 大寫字母表示數據行中允許 Null 值。

請注意,建議使用 PMSIHANDLE 類型的變數,因為安裝程式會在超出範圍時關閉 PMSIHANDLE 物件,而您必須呼叫 MsiCloseHandle 來關閉 MSIHANDLE 物件。 如需詳細資訊,請參閱 Windows Installer 最佳做法中的使用 PMSIHANDLE 而非 HANDLE 一節。

規格需求

需求
最低支援的用戶端 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