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 |