Freigeben über


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