MsiSourceListGetInfoA, fonction (msi.h)

La fonction MsiSourceListGetInfo récupère des informations sur la liste source d’un produit ou d’un correctif dans un contexte spécifique.

Syntaxe

UINT MsiSourceListGetInfoA(
  [in]                LPCSTR            szProductCodeOrPatchCode,
  [in, optional]      LPCSTR            szUserSid,
  [in]                MSIINSTALLCONTEXT dwContext,
  [in]                DWORD             dwOptions,
  [in]                LPCSTR            szProperty,
  [out, optional]     LPSTR             szValue,
  [in, out, optional] LPDWORD           pcchValue
);

Paramètres

[in] szProductCodeOrPatchCode

L'ProductCode ou le GUID du correctif du produit ou du correctif. Utilisez une chaîne terminée par null. Si la chaîne dépasse 39 caractères, la fonction échoue et retourne ERROR_INVALID_PARAMETER. Ce paramètre ne peut pas être NULL.

[in, optional] szUserSid

Ce paramètre peut être un identificateur de sécurité de chaîne (SID) qui spécifie le compte d’utilisateur qui contient le produit ou le correctif. Le SID n’est pas validé ou résolu. Un SID incorrect peut retourner ERROR_UNKNOWN_PRODUCT ou ERROR_UNKNOWN_PATCH. Lors du référencement d’un contexte d’ordinateur, szUserSID doit être NULL et dwContext doit être MSIINSTALLCONTEXT_MACHINE.

[in] dwContext

Ce paramètre spécifie le contexte de l’instance de produit ou de correctif. Ce paramètre peut contenir l’une des valeurs suivantes.

[in] dwOptions

La valeur dwOptions spécifie la signification de szProductCodeOrPatchCode.

[in] szProperty

Chaîne terminée par null qui spécifie la valeur de propriété à récupérer. Le paramètre szProperty peut être l’une des valeurs suivantes.

[out, optional] szValue

Mémoire tampon de sortie qui reçoit les informations. 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 le nombre d'TCHAR dans la valeur, sans inclure le caractère NULL de fin.

Si le szValue 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 szValue mémoire tampon suffisamment grande pour contenir *pcchValue + 1 caractères.

Si szValue et pcchValue sont tous 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 szValue. 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 szValue est également NULL , sinon la fonction retourne ERROR_INVALID_PARAMETER.

Valeur de retour

La fonction msiSourceListGetInfo retourne les valeurs suivantes.

Remarques

Les administrateurs peuvent modifier l’installation d’une instance de produit ou de correctif qui existe sous le contexte de l’ordinateur ou sous leur propre contexte par utilisateur (géré ou non managé.) Ils peuvent modifier l’installation d’une instance de produit ou de correctif qui existe sous le contexte géré par l’utilisateur. Les administrateurs ne peuvent pas modifier l’installation d’un autre utilisateur d’une instance de produit ou de correctif qui existe sous ce contexte non managé par utilisateur.

Les non-administrateurs ne peuvent pas modifier l’installation d’une instance de produit ou de correctif qui existe sous le contexte par utilisateur d’un autre utilisateur (géré ou non managé.) Ils peuvent modifier l’installation d’une instance de produit ou de correctif qui existe sous leur propre contexte non managé par utilisateur. Ils peuvent modifier l’installation d’une instance de produit ou de correctif sous le contexte de l’ordinateur ou leur propre contexte géré par l’utilisateur uniquement s’ils sont activés pour rechercher une source de produit ou de correctif. Les utilisateurs peuvent être activés pour rechercher des sources en définissant une stratégie. Pour plus d’informations, consultez DisableBrowse, AllowLockdownBrowseet stratégies de AlwaysInstallElevated.

Exigences

Voir aussi

MsiSourceListSetInfo

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

ProductCode