msiRecordSetStringA 函式 (msiquery.h)

MsiRecordSetString 函式會將字串複製到指定的欄位。

語法

UINT MsiRecordSetStringA(
  [in] MSIHANDLE hRecord,
  [in] UINT      iField,
  [in] LPCSTR    szValue
);

[in] hRecord

記錄的句柄。

[in] iField

指定要設定之記錄的欄位。

[in] szValue

指定欄位的字串值。

此函式會傳回UINT。

在 MsiRecordSetString 函式中，Null 字串指標和空字串都會將字段設定為 null。嘗試將值儲存在不存在的欄位中會導致錯誤。

若要將記錄字串字位設定為 null，請將 szValue 設定為 Null 字串或空字串。

注意

msiquery.h 標頭會根據 UNICODE 預處理器常數的定義，將 MsiRecordSetString 定義為別名，自動選取此函式的 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
標頭	msiquery.h
程式庫	Msi.lib
Dll	Msi.dll