MsiOpenPackageA, fonction (msi.h)

  • Article

La fonction MsiOpenPackage ouvre un package à utiliser avec les fonctions qui accèdent à la base de données de produit. La fonction msiCloseHandle doit être appelée avec le handle lorsque le handle n’est pas nécessaire.

Remarque Initialiser COM sur le même thread avant d’appeler laMsiOpenPackage , MsiOpenPackageExou fonction MsiOpenProduct.

 

Syntaxe

UINT MsiOpenPackageA(
  [in]  LPCSTR    szPackagePath,
  [out] MSIHANDLE *hProduct
);

Paramètres

[in] szPackagePath

Chemin d’accès au package.

[out] hProduct

Pointeur vers une variable qui reçoit le handle de produit.

Valeur de retour

Valeur Signification
ERROR_BAD_CONFIGURATION
 Les informations de configuration sont endommagées.
ERROR_INSTALL_FAILURE
 Impossible d’ouvrir le produit.
ERROR_INSTALL_REMOTE_PROHIBITED
 Windows Installer n’autorise pas l’installation à partir d’une connexion Bureau à distance.
ERROR_INVALID_PARAMETER
 Un paramètre non valide est passé à la fonction.
ERROR_SUCCESS
 La fonction s’exécute correctement.
 

Si cette fonction échoue, elle peut retourner un code d’erreur système. Pour plus d’informations, consultez codes d’erreur système.

Remarques

MsiOpenPackage peut accepter un handle de base de données ouvert sous la forme « #nnnn », où nnnn est le handle de base de données sous forme de chaîne, c’est-à-dire #123, au lieu d’un chemin d’accès au package. Cela est destiné aux tâches de développement telles que l’exécution d’actions de validation ou l’utilisation avec les outils de gestion de base de données.

Note

L’en-tête msi.h définit MsiOpenPackage comme alias qui sélectionne automatiquement la version ANSI ou Unicode de cette fonction en fonction de la définition de la constante de préprocesseur UNICODE. Le mélange de l’utilisation de l’alias neutre en encodage avec du code qui n’est pas neutre en encodage peut entraîner des incompatibilités qui entraînent des erreurs de compilation ou d’exécution. Pour plus d’informations, consultez Conventions pour les prototypes de fonction.

Exigences

Exigence Valeur
client minimum 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. Consultez la configuration requise de Windows Installer Run-Time pour plus d’informations sur le service pack Windows minimal requis par une version de Windows Installer.
plateforme cible Windows
d’en-tête msi.h
bibliothèque Msi.lib
DLL Msi.dll

Voir aussi

fonctions de requête produit