Funzione MsiGetProductCodeA (msi.h)

Articolo
11/20/2024

La funzione MsiGetProductCode restituisce il codice prodotto di un'applicazione usando il codice componente di un componente installato o annunciato dell'applicazione. Durante l'inizializzazione, un'applicazione deve determinare in quale codice prodotto è stato installato o annunciato.

Sintassi

UINT MsiGetProductCodeA(
  [in]  LPCSTR szComponent,
  [out] LPSTR  lpBuf39
);

Parametri

[in] szComponent

Questo parametro specifica il codice componente di un componente installato dall'applicazione. Questo sarà in genere il codice componente del componente contenente il file eseguibile dell'applicazione.

[out] lpBuf39

Puntatore a un buffer che riceve il codice prodotto. Questo buffer deve avere una lunghezza di 39 caratteri. I primi 38 caratteri sono relativi al GUID e l'ultimo carattere è per il carattere null di terminazione.

Valore restituito

Valore	Significato
ERROR_BAD_CONFIGURATION	I dati di configurazione sono danneggiati.
ERROR_INSTALL_FAILURE	Impossibile determinare il codice prodotto.
ERROR_INVALID_PARAMETER	Alla funzione è stato passato un parametro non valido.
ERROR_SUCCESS	La funzione è stata completata correttamente.
ERROR_UNKNOWN_COMPONENT	Il componente specificato è sconosciuto.

Osservazioni

Durante l'inizializzazione, un'applicazione deve determinare il codice prodotto in cui è stato installato. Un'applicazione può far parte di prodotti diversi in installazioni diverse. Ad esempio, un'applicazione può far parte di una suite di applicazioni o può essere installata da sola.

Nota

L'intestazione msi.h definisce MsiGetProductCode come alias che seleziona automaticamente la versione ANSI o Unicode di questa funzione in base alla definizione della costante del preprocessore UNICODE. La combinazione dell'utilizzo dell'alias indipendente dalla codifica con il codice non indipendente dalla codifica può causare mancate corrispondenze che generano errori di compilazione o di runtime. Per altre informazioni, vedere convenzioni di per i prototipi di funzioni.

Fabbisogno

Requisito	Valore
client minimo supportato	Windows Installer 5.0 in Windows Server 2012, Windows 8, Windows Server 2008 R2 o Windows 7. Windows Installer 4.0 o Windows Installer 4.5 in Windows Server 2008 o Windows Vista. Windows Installer in Windows Server 2003 o Windows XP. Per informazioni sul Service Pack minimo di Windows richiesto da una versione di Windows Installer, vedere Requisiti di windows Run-Time.
piattaforma di destinazione	Finestre
intestazione	msi.h
libreria	Msi.lib
dll	Msi.dll

Vedere anche

funzioni di Application-Only

Condividi tramite