MsiEnumRelatedProductsA, fonction (msi.h)

La fonction MsiEnumRelatedProducts énumère les produits avec un code de mise à niveau spécifié. Cette fonction répertorie les produits actuellement installés et publiés qui ont la propriété UpgradeCode spécifiée dans leur table de propriétés .

Syntaxe

UINT MsiEnumRelatedProductsA(
  [in]  LPCSTR lpUpgradeCode,
  [in]  DWORD  dwReserved,
  [in]  DWORD  iProductIndex,
  [out] LPSTR  lpProductBuf
);

Paramètres

[in] lpUpgradeCode

Chaîne terminée par null spécifiant le code de mise à niveau des produits associés que le programme d’installation doit énumérer.

[in] dwReserved

Ce paramètre est réservé et doit être 0.

[in] iProductIndex

Index de base zéro dans les produits inscrits.

[out] lpProductBuf

Mémoire tampon pour recevoir le GUID du code de produit. Cette mémoire tampon doit comporter 39 caractères. Les 38 premiers caractères concernent le GUID , et le dernier caractère correspond au caractère null de fin.

Valeur de retour

Remarques

Consultez propriété UpgradeCode.

Pour énumérer les produits actuellement installés et publiés qui ont un code de mise à niveau spécifique, une application doit appeler initialement la fonction MsiEnumRelatedProducts avec le paramètre iProductIndex défini sur zéro. L’application doit ensuite incrémenter le paramètre iProductIndex et appeler MsiEnumRelatedProducts jusqu’à ce que la fonction retourne ERROR_NO_MORE_ITEMS, ce qui signifie qu’il n’y a plus de produits avec le code de mise à niveau spécifié.

Lorsque vous effectuez plusieurs appels à MsiEnumRelatedProducts pour énumérer tous les produits associés, chaque appel doit être effectué à partir du même thread.

Exigences