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 Property.

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 enregistrés.

[out] lpProductBuf

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

Valeur retournée

Notes

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 initialement appeler 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.

Spécifications