Функция 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 определяет MsiRecordSetString в качестве псевдонима, который автоматически выбирает версию ANSI или Юникод этой функции на основе определения константы препроцессора UNICODE. Сочетание использования псевдонима, не зависящий от кодировки, с кодом, не зависящим от кодировки, может привести к несоответствиям, которые приводят к ошибкам компиляции или среды выполнения. Дополнительные сведения см. в разделе Соглашения для прототипов функций.

Требования

Требование	Значение
Минимальная версия клиента	Установщик Windows 5.0 в Windows Server 2012, Windows 8, Windows Server 2008 R2 или Windows 7. Установщик Windows 4.0 или Установщик Windows 4.5 в Windows Server 2008 или Windows Vista. Установщик Windows в Windows Server 2003 или Windows XP
Целевая платформа	Windows
Header	msiquery.h
Библиотека	Msi.lib
DLL	Msi.dll

См. также раздел

Функции обработки записей