Funzione MsiGetProductPropertyA (msi.h)
La funzione MsiGetProductProperty recupera le proprietà del prodotto. Queste proprietà si trovano nel database del prodotto.
Sintassi
UINT MsiGetProductPropertyA(
[in] MSIHANDLE hProduct,
[in] LPCSTR szProperty,
[out] LPSTR lpValueBuf,
[in, out] LPDWORD pcchValueBuf
);
Parametri
[in] hProduct
Handle al prodotto ottenuto da MsiOpenProduct.
[in] szProperty
Specifica la proprietà da recuperare. Questo valore fa distinzione tra maiuscole e minuscole.
[out] lpValueBuf
Puntatore a un buffer che riceve il valore della proprietà. Il valore viene troncato e terminato null se lpValueBuf è troppo piccolo. Questo parametro può essere null.
[in, out] pcchValueBuf
Puntatore a una variabile che specifica le dimensioni, in caratteri, del buffer a cui punta il parametro lpValueBuf . In input, questa è la dimensione completa del buffer, incluso uno spazio per un carattere null terminante. Se il buffer passato è troppo piccolo, il conteggio restituito non include il carattere null terminante.
Se lpValueBuf è null, pcchValueBuf può essere null.
Valore restituito
La funzione MsiGetProductProperty restituisce i valori seguenti.
| Valore | Significato |
|---|---|
|
Un parametro non valido è stato passato alla funzione. |
|
Un handle non valido è stato passato alla funzione. |
|
Un buffer è troppo piccolo per contenere l'intero valore della proprietà. |
|
La funzione è stata completata correttamente. |
Commenti
Quando la funzione MsiGetProductProperty restituisce, il parametro pcchValueBuf contiene la lunghezza della stringa archiviata nel buffer. Il conteggio restituito non include il carattere Null terminante. Se il buffer non è abbastanza grande, MsiGetProductProperty restituisce ERROR_MORE_DATA e MsiGetProductProperty contiene le dimensioni della stringa, in caratteri, senza contare il carattere Null.
Nota
L'intestazione msi.h definisce MsiGetProductProperty come alias che seleziona automaticamente la versione ANSI o Unicode di questa funzione in base alla definizione della costante preprocessore UNICODE. La combinazione dell'utilizzo dell'alias di codifica neutrale con il codice che non è neutrale dalla codifica può causare errori di corrispondenza che causano errori di compilazione o runtime. Per altre informazioni, vedere Convenzioni per i prototipi di funzione.
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 i requisiti di Windows Installer Run-Time. |
| Piattaforma di destinazione | Windows |
| Intestazione | msi.h |
| Libreria | Msi.lib |
| DLL | Msi.dll |