Funzione MsiGetProductCodeA (msi.h)
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. Si tratta in genere del 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 per il GUID e l'ultimo carattere è per il carattere Null di terminazione.
Valore restituito
| Valore | Significato |
|---|---|
|
I dati di configurazione sono danneggiati. |
|
Impossibile determinare il codice prodotto. |
|
Alla funzione è stato passato un parametro non valido. |
|
La funzione è stata completata correttamente. |
|
Il componente specificato è sconosciuto. |
Commenti
Durante l'inizializzazione, un'applicazione deve determinare il codice prodotto in cui è stato installato. Un'applicazione può far parte di diversi prodotti 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 che non è indipendente dalla codifica può causare mancate corrispondenze che generano errori di compilazione o di runtime. Per altre informazioni, vedere Convenzioni per i prototipi di funzioni.
Requisiti
| 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 Windows Installer Run-Time Requirements .See the Windows Installer requirements for information about the minimum Windows Service Pack that is required by a Windows Installer version. |
| Piattaforma di destinazione | Windows |
| Intestazione | msi.h |
| Libreria | Msi.lib |
| DLL | Msi.dll |