MsiGetActiveDatabase-Funktion (msiquery.h)

Die MsiGetActiveDatabase-Funktion gibt die aktive Datenbank für die Installation zurück. Diese Funktion gibt einen schreibgeschützten Handle zurück, der mit MsiCloseHandle geschlossen werden soll.

Syntax

MSIHANDLE MsiGetActiveDatabase(
  [in] MSIHANDLE hInstall
);

Parameter

[in] hInstall

Behandeln Sie die Installation, die für eine benutzerdefinierte DLL-Aktion bereitgestellt oder über MsiOpenPackage, MsiOpenPackageEx oder MsiOpenProduct abgerufen wird.

Rückgabewert

Wenn die Funktion erfolgreich ist, wird ein schreibgeschütztes Handle an die Datenbank zurückgegeben, die derzeit vom Installationsprogramm verwendet wird. Wenn die Funktion fehlschlägt, gibt die Funktion null, 0 zurück.

Hinweise

Die MsiGetActiveDatabase-Funktion greift auf die verwendete Datenbank zu, indem die Installation ausgeführt wird.

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.

Anforderungen

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