msiCreateRecord 函式 (msiquery.h)

MsiCreateRecord 函式會建立具有指定字段數目的新記錄物件。此函式會傳回應該使用 MsiCloseHandle 關閉的句柄。

語法

MSIHANDLE MsiCreateRecord(
  [in] UINT cParams
);

[in] cParams

指定記錄將擁有的欄位數目。記錄中的欄位數目上限限製為 65535。

如果函式成功，傳回值會處理至新的記錄物件。

如果函式失敗，則傳回值為 null。

MsiCreateRecord 函式所建立之記錄物件的欄位 0 用於格式化字串和作業程式碼，而且不包含在 cParams 指定的計數中。所有欄位都會初始化為 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