Funzione MsiEnumRelatedProductsW (msi.h)

La funzione MsiEnumRelatedProducts enumera i prodotti con un codice di aggiornamento specificato. Questa funzione elenca i prodotti attualmente installati e annunciati con la proprietà UpgradeCode specificata nella tabella Proprietà.

Sintassi

UINT MsiEnumRelatedProductsW(
  [in]  LPCWSTR lpUpgradeCode,
  [in]  DWORD   dwReserved,
  [in]  DWORD   iProductIndex,
  [out] LPWSTR  lpProductBuf
);

Parametri

[in] lpUpgradeCode

Stringa con terminazione null che specifica il codice di aggiornamento dei prodotti correlati che il programma di installazione deve enumerare.

[in] dwReserved

Questo parametro è riservato e deve essere 0.

[in] iProductIndex

Indice in base zero nei prodotti registrati.

[out] lpProductBuf

Buffer per ricevere il GUID del codice prodotto. Questo buffer deve essere lungo 39 caratteri. I primi 38 caratteri sono per il GUID e l'ultimo carattere è per il carattere null terminante.

Valore restituito

Commenti

Vedere La proprietà UpgradeCode .

Per enumerare prodotti attualmente installati e annunciati con codice di aggiornamento specifico, un'applicazione deve inizialmente chiamare la funzione MsiEnumRelatedProducts con il parametro iProductIndex impostato su zero. L'applicazione deve quindi aumentare il parametro iProductIndex e chiamare MsiEnumRelatedProducts fino a quando la funzione restituisce ERROR_NO_MORE_ITEMS, il che significa che non sono presenti più prodotti con il codice di aggiornamento specificato.

Quando si effettuano più chiamate a MsiEnumRelatedProducts per enumerare tutti i prodotti correlati, ogni chiamata deve essere eseguita dallo stesso thread.

Requisiti