Funzione MsiGetPatchInfoA (msi.h)
La funzione MsiGetPatchInfo restituisce informazioni su una patch.
Sintassi
UINT MsiGetPatchInfoA(
[in] LPCSTR szPatch,
[in] LPCSTR szAttribute,
[out] LPSTR lpValueBuf,
[in, out] LPDWORD pcchValueBuf
);
Parametri
[in] szPatch
Specifica il codice patch per il pacchetto patch.
[in] szAttribute
Specifica l'attributo da recuperare.
| Attributo | Significato |
|---|---|
|
Pacchetto memorizzato nella cache locale. |
[out] lpValueBuf
Puntatore a un buffer che riceve il valore della proprietà. 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 . Nell'input si tratta della dimensione completa del buffer, incluso uno spazio per un carattere Null di terminazione. Se il buffer passato è troppo piccolo, il conteggio restituito non include il carattere Null di terminazione.
Se lpValueBuf è null, pcchValueBuf può essere null.
Valore restituito
La funzione MsiGetPatchInfo restituisce i valori seguenti.
| Valore | Significato |
|---|---|
|
I dati di configurazione sono danneggiati. |
|
Alla funzione è stato passato un parametro non valido. |
|
Un buffer è troppo piccolo per contenere i dati richiesti. |
|
La funzione è stata completata correttamente. |
|
Il pacchetto patch non è installato. |
|
La proprietà non è riconosciuta. |
Commenti
Quando viene restituita la funzione MsiGetPatchInfo , il parametro pcchValueBuf contiene la lunghezza della stringa di classe archiviata nel buffer. Il conteggio restituito non include il carattere Null di terminazione.
Se il buffer è troppo piccolo per contenere i dati richiesti, MsiGetPatchInfo restituisce ERROR_MORE_DATA e pcchValueBuf contiene il numero di caratteri copiati in lpValueBuf, senza contare il carattere Null.
Nota
L'intestazione msi.h definisce MsiGetPatchInfo 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
| 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 |
Vedi anche
Non supportato in Windows Installer 2.0 e versioni precedenti