MsiDatabaseOpenViewA-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 MsiDatabaseOpenViewA(
  [in]  MSIHANDLE hDatabase,
  [in]  LPCSTR    szQuery,
  [out] MSIHANDLE *phView
);

Parameter

[in] hDatabase

Behandeln Sie die Datenbank, für die Sie ein Ansichtsobjekt öffnen möchten. Sie können das Handle wie unter Abrufen eines Datenbankhandles beschrieben abrufen.

[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:

ERROR_SUCCESS erfolgreich, und das Ansichtshandle, auf das der phView [out]-Parameter verweist, ist festgelegt.

ERROR_INVALID_HANDLE, ERROR_INVALID_HANDLE_STATE, ERROR_BAD_QUERY_SYNTAX oder ERROR_GEN_FAILURE bei Fehler und legt den Fehlerdatensatz fest, auf den über MsiGetLastErrorRecord zugegriffen werden kann.

Hinweise

Die MsiDatabaseOpenView-Funktion öffnet ein Ansichtsobjekt für eine Datenbank. Sie müssen ein Ansichtsobjekt für eine Datenbank öffnen, bevor Sie die Ausführung oder den Abruf ausführen.

Wenn ein Fehler auftritt, können Sie MsiGetLastErrorRecord aufrufen, um weitere Informationen zu erhalten.

Beachten Sie, dass es empfohlen wird, Variablen des Typs PMSIHANDLE zu verwenden, da das Installationsprogramm PMSIHANDLE-Objekte schließt, wenn sie aus dem Bereich gehen, während Sie MSIHANDLE-Objekte schließen müssen, indem Sie MsiCloseHandle aufrufen. 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 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

Allgemeine Datenbankzugriffsfunktionen