Partager via


MsiGetActiveDatabase, fonction (msiquery.h)

La fonction MsiGetActiveDatabase retourne la base de données active pour l’installation. Cette fonction retourne un handle en lecture seule qui doit être fermé à l’aide de MsiCloseHandle.

Syntaxe

MSIHANDLE MsiGetActiveDatabase(
  [in] MSIHANDLE hInstall
);

Paramètres

[in] hInstall

Gérez l’installation fournie à une action personnalisée DLL ou obtenue via MsiOpenPackage, MsiOpenPackageEx ou MsiOpenProduct.

Valeur retournée

Si la fonction réussit, elle retourne un handle en lecture seule à la base de données actuellement utilisée par le programme d’installation. Si la fonction échoue, la fonction retourne zéro, 0.

Notes

La fonction MsiGetActiveDatabase accède à la base de données utilisée par le qui exécute l’installation.

Notez qu’il est recommandé d’utiliser des variables de type PMSIHANDLE, car le programme d’installation ferme les objets PMSIHANDLE en dehors de leur portée, tandis que vous devez fermer les objets MSIHANDLE en appelant MsiCloseHandle. Pour plus d’informations, consultez la section Utiliser PMSIHANDLE au lieu de HANDLE dans les Bonnes pratiques de Windows Installer.

Spécifications

   
Client minimal pris en charge Windows Installer 5.0 sur Windows Server 2012, Windows 8, Windows Server 2008 R2 ou Windows 7. Windows Installer 4.0 ou Windows Installer 4.5 sur Windows Server 2008 ou Windows Vista. Windows Installer sur Windows Server 2003 ou Windows XP
Plateforme cible Windows
En-tête msiquery.h
Bibliothèque Msi.lib
DLL Msi.dll

Voir aussi

Fonctions générales d’accès à la base de données