Partager via


MsiCollectUserInfoW, fonction (msi.h)

La fonction MsiCollectUserInfo obtient et stocke les informations utilisateur et l’ID de produit à partir d’un Assistant d’installation.

Syntaxe

UINT MsiCollectUserInfoW(
  [in] LPCWSTR szProduct
);

Paramètres

[in] szProduct

Spécifie le code de produit du produit pour lequel les informations utilisateur sont collectées.

Valeur retournée

Valeur Signification
ERROR_INVALID_PARAMETER
Un paramètre non valide a été transmis à la fonction.
ERROR_SUCCESS
La fonction a réussi.
Erreur liée à une action
Consultez Codes d’erreur.
Erreur d’initialisation
Une erreur relative à l’initialisation s’est produite.
 
 

Remarques

La fonction MsiCollectUserInfo est généralement appelée par une application lors de la première exécution de l’application. L’application appelle d’abord MsiGetUserInfo. Si cet appel échoue, l’application appelle MsiCollectUserInfo. MsiCollectUserInfo ouvre le package d’installation du produit et appelle une séquence d’Assistant qui collecte des informations utilisateur. Une fois la séquence terminée, les informations utilisateur sont inscrites. Étant donné que cette API nécessite une interface utilisateur créée, le niveau d’interface utilisateur doit être défini sur complet en appelant MsiSetInternalUI comme INSTALLUILEVEL_FULL.

MsiCollectUserInfo appelle une boîte de dialogue FirstRun.

Notes

L’en-tête msi.h définit MsiCollectUserInfo en tant qu’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. La combinaison 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.

Configuration requise

Condition requise Valeur
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. Pour plus d’informations sur le Service Pack Windows requis par une version de Windows Installer, consultez Configuration requise pour le runtime Windows.
Plateforme cible Windows
En-tête msi.h
Bibliothèque Msi.lib
DLL Msi.dll

Voir aussi

Fonctions spécifiques à l’application

Codes d’erreur

Erreur d’initialisation