MsiGetUserInfoA, fonction (msi.h)

Article
11/20/2024

La fonction MsiGetUserInfo retourne les informations utilisateur inscrites pour un produit installé.

Syntaxe

USERINFOSTATE MsiGetUserInfoA(
  [in]      LPCSTR  szProduct,
  [out]     LPSTR   lpUserNameBuf,
  [in, out] LPDWORD pcchUserNameBuf,
  [out]     LPSTR   lpOrgNameBuf,
  [in, out] LPDWORD pcchOrgNameBuf,
  [in]      LPSTR   lpSerialBuf,
  [in, out] LPDWORD pcchSerialBuf
);

Paramètres

[in] szProduct

Spécifie le code de produit pour que le produit soit interrogé.

[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 pointée par 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 de l’organisation.

[in, out] pcchOrgNameBuf

Pointeur vers une variable qui spécifie la taille, en caractères, de la mémoire tampon pointée par le paramètre lpOrgNameBuf. Lors de l’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 pointée par le paramètre lpSerialBuf. Lors de l’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 de retour

Valeur	Signification
USERINFOSTATE_ABSENT	Certaines ou toutes les informations utilisateur sont absentes.
USERINFOSTATE_INVALIDARG	L’un des paramètres de fonction n’était pas valide.
USERINFOSTATE_MOREDATA	Une mémoire tampon est trop petite pour contenir les données demandées.
USERINFOSTATE_PRESENT	La fonction s’est terminée correctement.
USERINFOSTATE_UNKNOWN	Le code du produit n’identifie pas un produit connu.

Remarques

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 suffisamment 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 présentes même en l’absence de nom de société.

Note

L’en-tête msi.h définit MsiGetUserInfo 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 d’état système

Partager via