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 |