MsiGetProductInfoExA, fonction (msi.h)

La fonction MsiGetProductInfoEx retourne des informations sur le produit pour les produits publiés et installés. Cette fonction peut récupérer des informations

à propos d’une instance d’un produit installé sous un compte d’utilisateur autre que l’utilisateur actuel.

Le processus appelant doit disposer de privilèges d’administration pour un utilisateur différent de l’utilisateur actuel. La fonction MsiGetProductInfoEx ne peut pas interroger une instance d’un produit publié dans un contexte non managé par utilisateur pour un compte d’utilisateur autre que l’utilisateur actuel.

Cette fonction est une extension de la fonction MsiGetProductInfo.

Syntaxe

UINT MsiGetProductInfoExA(
  [in]                LPCSTR            szProductCode,
  [in]                LPCSTR            szUserSid,
  [in]                MSIINSTALLCONTEXT dwContext,
  [in]                LPCSTR            szProperty,
  [out, optional]     LPSTR             szValue,
  [in, out, optional] LPDWORD           pcchValue
);

Paramètres

[in] szProductCode

Le ProductCode GUID de l’instance de produit interrogée.

[in] szUserSid

Identificateur de sécurité (SID) du compte sous lequel l’instance du produit interrogé existe. Une NULL spécifie le SID d’utilisateur actuel.

[in] dwContext

Contexte d’installation de l’instance de produit interrogée.

[in] szProperty

Propriété interrogée.

Propriété à récupérer. Les propriétés du tableau suivant ne peuvent être récupérées qu’à partir d’applications déjà installées. Toutes les propriétés requises sont garanties d’être disponibles, mais d’autres propriétés sont disponibles uniquement si la propriété est définie. Pour plus d’informations, consultez
Propriétés requises et propriétés .

Pour récupérer l’ID de produit, le propriétaire inscrit ou l’entreprise inscrite à partir d’applications installées, définissez szProperty sur l’une des valeurs de chaîne de texte suivantes.

Pour récupérer le type d’instance du produit, définissez szProperty sur la valeur suivante. Cette propriété est disponible pour les produits publiés ou installés.

Les propriétés du tableau suivant peuvent être récupérées à partir d’applications publiées ou installées. Ces propriétés ne peuvent pas être récupérées pour les instances de produit installées sous un contexte non managé par utilisateur pour les comptes d’utilisateur autres que le compte d’utilisateur actuel.

[out, optional] szValue

Pointeur vers une mémoire tampon qui reçoit la valeur de la propriété. Cette mémoire tampon doit être suffisamment grande pour contenir les informations. Si la mémoire tampon est trop petite, la fonction retourne ERROR_MORE_DATA et définit *pcchValue au nombre de TCHAR dans la valeur, sans inclure le caractère NULL de fin.

Si lpValue est défini sur NULL et pcchValue est défini sur un pointeur valide, la fonction retourne ERROR_SUCCESS et définit *pcchValue le nombre de TCHAR dans la valeur, sans inclure le caractère NULL de fin. La fonction peut ensuite être appelée à nouveau pour récupérer la valeur, avec lpValue mémoire tampon suffisamment grande pour contenir *pcchValue + 1 caractères.

Si lpValue et pcchValue sont tous les deux définis sur NULL, la fonction retourne ERROR_SUCCESS si la valeur existe, sans récupérer la valeur.

[in, out, optional] pcchValue

Pointeur vers une variable qui spécifie le nombre de TCHAR dans la mémoire tampon lpValue . Lorsque la fonction est retournée, ce paramètre est défini sur la taille de la valeur demandée si la fonction copie la valeur dans la mémoire tampon spécifiée. La taille est retournée en tant que nombre de TCHAR dans la valeur demandée, sans inclure le caractère null de fin.

Ce paramètre peut être défini sur NULL uniquement si lpValue est également NULL. Sinon, la fonction retourne ERROR_INVALID_PARAMETER.

Valeur de retour

La fonction MsiGetProductInfoEx retourne les valeurs suivantes.

Remarques

Lorsque la fonction MsiGetProductInfoEx retourne, le paramètre pcchValue contient la longueur de la chaîne 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, MsiGetProductInfoEx retourne ERROR_MORE_DATA, et le paramètre pcchValue contient la taille de la chaîne, dans TCHAR, sans compter le caractère null.

La fonction MsiGetProductInfoEx (INSTALLPROPERTY_LOCALPACKAGE) retourne un chemin d’accès au package mis en cache. Le package mis en cache est destiné uniquement à une utilisation interne. Les installations en mode maintenance doivent être appelées via les fonctions msiConfigureFeature , msiConfigureProductou fonctions MsiConfigureProductEx.

La fonction MsiGetProductInfo retourne ERROR_UNKNOWN_PROPERTY si l’application interrogée est annoncée et non installée. Par exemple, si l’application est annoncée et non installée, une requête pour INSTALLPROPERTY_INSTALLLOCATION retourne une erreur de ERROR_UNKNOWN_PROPERTY.

Exigences

Voir aussi

ARPHELPLINK

ARPHELPTELEPHONE

ARPINSTALLLOCATION

ARPPRODUCTICON

ARPURLINFOABOUT

ARPURLUPDATEINFO

Fabricant

msiConfigureFeature

MsiConfigureProduct

msiConfigureProductEx

non pris en charge dans Windows Installer 2.0 et versions antérieures

codes de package

ProductCode

ProductID

ProductName

ProductVersion

propriétés

propriétés requises

sourceDir

fonctions d’état système