Funzione MsiExtractPatchXMLDataA (msi.h)

La funzione MsiExtractPatchXMLData estrae informazioni da una patch che può essere usata per determinare se la patch si applica a un sistema di destinazione. La funzione restituisce una stringa XML che può essere fornita a MsiDeterminePatchSequence e MsiDetermineApplicablePatches anziché al file di patch completo. Le informazioni restituite possono essere usate per determinare se la patch è applicabile.

Sintassi

UINT MsiExtractPatchXMLDataA(
  [in]                LPCSTR  szPatchPath,
  [in]                DWORD   dwReserved,
  [out, optional]     LPSTR   szXMLData,
  [in, out, optional] LPDWORD pcchXMLData
);

Parametri

[in] szPatchPath

Percorso completo della patch che viene eseguita una query. Passare come stringa con terminazione Null. Questo parametro non può essere NULL.

[in] dwReserved

Argomento riservato che deve essere 0 (zero).

[out, optional] szXMLData

Puntatore a un buffer per contenere la stringa XML contenente le informazioni sulle patch estratte. Questo buffer deve essere abbastanza grande per contenere le informazioni ricevute. Se il buffer è troppo piccolo, la funzione restituisce ERROR_MORE_DATA e imposta *pcchXMLData sul numero di TCHAR nel valore, non incluso il carattere NULL di terminazione.

Se szXMLData è impostato su NULL e pcchXMLData è impostato su un puntatore valido, la funzione restituisce ERROR_SUCCESS e imposta *pcchXMLData sul numero di TCHAR nel valore, non incluso il carattere NULL terminante. La funzione può quindi essere chiamata di nuovo per recuperare il valore, con buffer szXMLData abbastanza grande per contenere *pcchXMLData + 1 caratteri.

[in, out, optional] pcchXMLData

Puntatore a una variabile che specifica il numero di TCHAR nel buffer szXMLData . Quando la funzione restituisce, questo parametro viene impostato sulla dimensione del valore richiesto se la funzione copia il valore nel buffer specificato. La dimensione viene restituita come numero di TCHAR nel valore richiesto, non incluso il carattere Null terminante.

Se questo parametro è impostato su NULL, la funzione restituisce ERROR_INVALID_PARAMETER.

Valore restituito

La funzione MsiExtractPatchXMLData può restituire i valori seguenti.

Codice restituito Descrizione
ERROR_FUNCTION_FAILED
La funzione non è riuscita in modo che non sia identificata da nessuno dei valori restituiti in questa tabella.
ERROR_INVALID_PARAMETER
Un parametro non valido è stato passato alla funzione.
ERROR_MORE_DATA
Il valore non rientra nel buffer fornito.
ERROR_PATCH_OPEN_FAILED
Impossibile aprire il file di patch.
ERROR_SUCCESS
La funzione ha avuto esito positivo.
ERROR_PATCH_PACKAGE_INVALID
Impossibile aprire il file di patch.
ERROR_CALL_NOT_IMPLEMENTED
Questo errore può essere restituito se MSXML 3.0 non è installato.

Commenti

Il metodo ExtractPatchXMLData dell'oggetto Installer usa la funzione MsiExtractPatchXMLData .

Nota

L'intestazione msi.h definisce MsiExtractPatchXMLData 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 4.0 o Windows Installer 4.5 in Windows Server 2008 o Windows Vista. Windows Installer 3.0 o versione successiva 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

Vedi anche

MsiDetermineApplicablePatches

MsiDeterminePatchSequence

Non supportato in Windows Installer 2.0 e versioni precedenti