MsiGetUserInfoW, fonction (msi.h)
La fonction MsiGetUserInfo retourne les informations utilisateur inscrites pour un produit installé.
Syntaxe
USERINFOSTATE MsiGetUserInfoW(
[in] LPCWSTR szProduct,
[out] LPWSTR lpUserNameBuf,
[in, out] LPDWORD pcchUserNameBuf,
[out] LPWSTR lpOrgNameBuf,
[in, out] LPDWORD pcchOrgNameBuf,
[in] LPWSTR lpSerialBuf,
[in, out] LPDWORD pcchSerialBuf
);
Paramètres
[in] szProduct
Spécifie le code de produit pour le produit à interroger.
[out] lpUserNameBuf
Pointeur vers une variable qui reçoit le nom de l’utilisateur.
[in, out] pcchUserNameBuf
Pointeur vers une variable qui spécifie la taille, en caractères, de la mémoire tampon vers laquelle pointe le paramètre lpUserNameBuf . Cette taille doit inclure le caractère null de fin.
[out] lpOrgNameBuf
Pointeur vers une mémoire tampon qui reçoit le nom organization.
[in, out] pcchOrgNameBuf
Pointeur vers une variable qui spécifie la taille, en caractères, de la mémoire tampon vers laquelle pointe le paramètre lpOrgNameBuf . En entrée, il s’agit de la taille complète de la mémoire tampon, y compris un espace pour un caractère null de fin. Si la mémoire tampon passée est trop petite, le nombre retourné n’inclut pas le caractère null de fin.
[in] lpSerialBuf
Pointeur vers une mémoire tampon qui reçoit l’ID de produit.
[in, out] pcchSerialBuf
Pointeur vers une variable qui spécifie la taille, en caractères, de la mémoire tampon vers laquelle pointe le paramètre lpSerialBuf . En entrée, il s’agit de la taille complète de la mémoire tampon, y compris un espace pour un caractère null de fin. Si la mémoire tampon passée est trop petite, le nombre retourné n’inclut pas le caractère null de fin.
Valeur retournée
Valeur | Signification |
---|---|
|
Une partie ou la totalité des informations utilisateur sont absentes. |
|
L’un des paramètres de fonction n’était pas valide. |
|
Une mémoire tampon est trop petite pour contenir les données demandées. |
|
La fonction s’est terminée avec succès. |
|
Le code de produit n’identifie pas un produit connu. |
Notes
Lorsque la fonction MsiGetUserInfo retourne, le paramètre pcchNameBuf contient la longueur de la chaîne de classe stockée dans la mémoire tampon. Le nombre retourné n’inclut pas le caractère null de fin. Si la mémoire tampon n’est pas assez grande, la fonction MsiGetUserInfo retourne USERINFOSTATE_MOREDATA, et MsiGetUserInfo contient la taille de la chaîne, en caractères, sans compter le caractère null.
Les informations utilisateur sont considérées comme étant présentes même en l’absence de nom d’entreprise.
Notes
L’en-tête msi.h définit MsiGetUserInfo comme un 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.
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. 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 |