MsiRecordSetStringA-Funktion (msiquery.h)

  • Artikel

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

Handle mit dem 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.

Hinweise

In der MsiRecordSetString-Funktion legen ein NULL-Zeichenfolgenzeiger und eine leere Zeichenfolge das Feld auf NULL fest. Der Versuch, einen Wert in einem nicht vorhandenen Feld zu speichern, löst einen Fehler aus.

Um ein Datensatzzeichenfolgenfeld auf NULL festzulegen, legen Sie szValue entweder auf eine NULL-Zeichenfolge oder eine leere Zeichenfolge fest.

Hinweis

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 nicht codierungsneutralem Code 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
Unterstützte Mindestversion (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 Windows
Kopfzeile msiquery.h
Bibliothek Msi.lib
DLL Msi.dll

Weitere Informationen

Datensatzverarbeitungsfunktionen