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 |