Freigeben über


MsiRecordSetStringA-Funktion (msiquery.h)

Die MsiRecordSetString--Funktion kopiert eine Zeichenfolge in das angegebene Feld.

Syntax

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

Parameter

[in] hRecord

Behandeln sie den Datensatz.

[in] iField

Gibt das Feld des festzulegenden Datensatzes an.

[in] szValue

Gibt den Zeichenfolgenwert des Felds an.

Rückgabewert

Diese Funktion gibt UINT zurück.

Bemerkungen

In der MsiRecordSetString--Funktion legen ein Nullzeichenfolgenzeiger und eine leere Zeichenfolge das Feld auf NULL fest. Wenn Sie versuchen, einen Wert in einem nicht vorhandenen Feld zu speichern, tritt ein Fehler auf.

Wenn Sie ein Datensatzzeichenfolgenfeld auf NULL festlegen möchten, legen Sie szValue entweder auf eine NULL-Zeichenfolge oder eine leere Zeichenfolge fest.

Anmerkung

Der msiquery.h-Header definiert MsiRecordSetString als Alias, der die ANSI- oder Unicode-Version dieser Funktion basierend auf der Definition der UNICODE-Präprozessorkonstante automatisch auswählt. Das Mischen der Verwendung des codierungsneutralen Alias mit Code, der nicht codierungsneutral ist, kann zu Nichtübereinstimmungen führen, die zu Kompilierungs- oder Laufzeitfehlern führen. Weitere Informationen finden Sie unter Konventionen für Funktionsprototypen.

Anforderungen

Anforderung Wert
mindestens unterstützte Client- Windows Installer 5.0 unter Windows Server 2012, Windows 8, Windows Server 2008 R2 oder Windows 7. Windows Installer 4.0 oder Windows Installer 4.5 unter Windows Server 2008 oder Windows Vista. Windows Installer unter Windows Server 2003 oder Windows XP
Zielplattform- Fenster
Header- msiquery.h
Library Msi.lib
DLL- Msi.dll

Siehe auch

Datensatzverarbeitungsfunktionen