MsiEnumComponentsExA, fonction (msi.h)

La fonction MsiEnumComponentsEx énumère les composants installés. La fonction récupère le code du composant pour un composant chaque fois qu’il est appelé. Le code du composant est le GUID de chaîne unique au composant, à la version et au langage.

Windows Installer 4.5 ou version antérieure: Non pris en charge. Cette fonction est disponible à partir de Windows Installer 5.0.

Syntaxe

UINT MsiEnumComponentsExA(
  [in, optional]  LPCSTR            szUserSid,
  [in]            DWORD             dwContext,
  [in]            DWORD             dwIndex,
  [out, optional] CHAR [39]         szInstalledComponentCode,
  [out, optional] MSIINSTALLCONTEXT *pdwInstalledContext,
  [out, optional] LPSTR             szSid,
  [in, out]       LPDWORD           pcchSid
);

Paramètres

[in, optional] szUserSid

Chaîne terminée par null qui contient un identificateur de sécurité (SID.) L’énumération des composants installés s’étend aux utilisateurs identifiés par ce SID. La chaîne SID spéciale s-1-1-0 (Tout le monde) spécifie une énumération de tous les composants installés sur tous les produits de tous les utilisateurs du système. Une valeur SID autre que s-1-1-0 spécifie un SID utilisateur pour un utilisateur particulier et limite l’énumération aux instances d’applications installées par l’utilisateur spécifié.

[in] dwContext

Indicateur qui limite l’énumération du composant installé aux instances de produits installées dans le contexte d’installation spécifié. L’énumération inclut uniquement les instances de produit installées par les utilisateurs spécifiés par szUserSid.

[in] dwIndex

Spécifie l’index du composant à récupérer. Ce paramètre doit être égal à zéro (0) pour le premier appel à MsiEnumComponentsEx fonction. Pour chaque appel suivant, l’index doit être incrémenté de 1. L’index ne doit être incrémenté que si l’appel précédent à la fonction retourne ERROR_SUCCESS. Les composants ne sont pas ordonnés et peuvent être retournés par la fonction dans n’importe quel ordre.

[out, optional] szInstalledComponentCode

Mémoire tampon de sortie qui reçoit le GUID de code du composant pour le composant installé. La longueur de la mémoire tampon doit être suffisamment grande pour contenir une valeur de chaîne terminée par null contenant le code du composant. Les 38 premiers caractères TCHAR reçoivent le GUID du composant, et le 39e caractère reçoit un caractère NULL de fin.

[out, optional] pdwInstalledContext

Indicateur qui donne le contexte d’installation à l’application qui a installé le composant.

[out, optional] szSid

Reçoit l’identificateur de sécurité (SID) qui identifie l’utilisateur qui a installé l’application propriétaire du composant. L’emplacement reçoit une chaîne vide si cette instance de l’application est installée dans un contexte d’installation par ordinateur.

La longueur de la mémoire tampon à cet emplacement doit être suffisamment grande pour contenir une valeur de chaîne terminée par null contenant le SID. Si la mémoire tampon est trop petite, la fonction retourne ERROR_MORE_DATA et l’emplacement vers lequel pointe pcchSid reçoit le nombre d'TCHAR dans le SID, sans inclure le caractère NULL de fin.

Si szSid est défini sur NULL et pcchSid est un pointeur valide vers un emplacement en mémoire, la fonction retourne ERROR_SUCCESS et l’emplacement reçoit le nombre de TCHAR dans le SID, sans inclure le caractère Null de fin. La fonction peut ensuite être appelée à nouveau pour récupérer la valeur, avec le szSid mémoire tampon redimensionnée suffisamment grande pour contenir *pcchSid + 1 caractères.

[in, out] pcchSid

Reçoit le nombre de TCHAR dans le SID, sans inclure le caractère null de fin. Lorsque la fonction est retournée, cette variable est définie sur la taille du SID demandé si la fonction peut copier correctement le SID et terminer le caractère null dans l’emplacement de la mémoire tampon vers lequel pointe szSid. 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 szSid est également NULL , sinon la fonction retourne ERROR_INVALID_PARAMETER. Si szSid et pcchSid sont tous deux définis sur NULL, la fonction retourne ERROR_SUCCESS si le SID existe, sans récupérer la valeur SID.

Valeur de retour

La fonction MsiEnumProductsEx retourne l’une des valeurs suivantes.

Remarques

Exigences