MsiCreateRecord-Funktion (msiquery.h)

Die MsiCreateRecord-Funktion erstellt ein neues Datensatzobjekt mit der angegebenen Anzahl von Feldern. Diese Funktion gibt ein Handle zurück, das mit MsiCloseHandle geschlossen werden soll.

Syntax

MSIHANDLE MsiCreateRecord(
  [in] UINT cParams
);

Parameter

[in] cParams

Gibt die Anzahl der Felder an, über die der Datensatz verfügen soll. Die maximale Anzahl von Feldern in einem Datensatz ist auf 65535 beschränkt.

Rückgabewert

Wenn die Funktion erfolgreich ist, wird der Rückgabewert an ein neues Datensatzobjekt verarbeitet.

Wenn die Funktion fehlschlägt, ist der Rückgabewert NULL.

Hinweise

Feld 0 des datensatzobjekts, das von der MsiCreateRecord-Funktion erstellt wurde, wird für Formatzeichenfolgen und Vorgangscodes verwendet und ist nicht in der von cParams angegebenen Anzahl enthalten. Alle Felder werden mit NULL initialisiert.

Beachten Sie, dass die Verwendung von Variablen vom Typ PMSIHANDLE empfohlen wird, da das Installationsprogramm PMSIHANDLE-Objekte schließt, wenn sie den Gültigkeitsbereich sprengen, während Sie MSIHANDLE-Objekte durch Aufrufen von MsiCloseHandle schließen müssen. Weitere Informationen finden Sie im Abschnitt Verwenden von PMSIHANDLE anstelle von HANDLE im Abschnitt Bewährte Methoden für Windows Installer.

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

Datenbankfunktionen

Datensatzverarbeitungsfunktionen