MsiDatabaseOpenViewW-Funktion (msiquery.h)
Die MsiDatabaseOpenView-Funktion bereitet eine Datenbankabfrage vor und erstellt ein Ansichtsobjekt. Diese Funktion gibt ein Handle zurück, das mit MsiCloseHandle geschlossen werden soll.
Syntax
UINT MsiDatabaseOpenViewW(
[in] MSIHANDLE hDatabase,
[in] LPCWSTR szQuery,
[out] MSIHANDLE *phView
);
Parameter
[in] hDatabase
Handle für die Datenbank, für die Sie ein Ansichtsobjekt öffnen möchten. Sie können das Handle abrufen, wie unter Abrufen eines Datenbankhandles beschrieben.
[in] szQuery
Gibt eine SQL-Abfragezeichenfolge zum Abfragen der Datenbank an. Informationen zur richtigen Syntax finden Sie unter SQL-Syntax.
[out] phView
Zeiger auf ein Handle für die zurückgegebene Ansicht.
Rückgabewert
Die MsiDatabaseOpenView-Funktion gibt einen der folgenden Werte zurück:
Hinweise
Die MsiDatabaseOpenView-Funktion öffnet ein Ansichtsobjekt für eine Datenbank. Sie müssen ein Ansichtsobjekt für eine Datenbank öffnen, bevor Sie eine Ausführung oder einen Abruf ausführen.
Wenn ein Fehler auftritt, können Sie MsiGetLastErrorRecord aufrufen, um weitere Informationen zu erhalten.
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.
Wenn die Funktion fehlschlägt, können Sie erweiterte Fehlerinformationen mithilfe von MsiGetLastErrorRecord abrufen.
Hinweis
Der msiquery.h-Header definiert MsiDatabaseOpenView 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 |
---|---|
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
Feedback
https://aka.ms/ContentUserFeedback.
Bald verfügbar: Im Laufe des Jahres 2024 werden wir GitHub-Issues stufenweise als Feedbackmechanismus für Inhalte abbauen und durch ein neues Feedbacksystem ersetzen. Weitere Informationen finden Sie unterFeedback senden und anzeigen für