Funzione MsiGetPatchInfoW (msi.h)

Articolo
11/20/2024

La funzione msiGetPatchInfo restituisce informazioni su una patch.

Sintassi

UINT MsiGetPatchInfoW(
  [in]      LPCWSTR szPatch,
  [in]      LPCWSTR szAttribute,
  [out]     LPWSTR  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
INSTALLPROPERTY_LOCALPACKAGE	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 delle dimensioni complete 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
ERROR_BAD_CONFIGURATION	I dati di configurazione sono danneggiati.
ERROR_INVALID_PARAMETER	Alla funzione è stato passato un parametro non valido.
ERROR_MORE_DATA	Un buffer è troppo piccolo per contenere i dati richiesti.
ERROR_SUCCESS	La funzione è stata completata correttamente.
ERROR_UNKNOWN_PRODUCT	Il pacchetto patch non è installato.
ERROR_UNKNOWN_PROPERTY	La proprietà non è riconosciuta.

Osservazioni

Quando viene restituita la funzione msiGetPatchInfo 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 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

non supportato in Windows Installer 2.0 e versioni precedenti

Condividi tramite