共用方式為


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

另請參閱

資料庫函式

記錄處理函式