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 |
---|---|
|
La funzione non è riuscita in modo che non sia identificata da nessuno dei valori restituiti in questa tabella. |
|
Un parametro non valido è stato passato alla funzione. |
|
Il valore non rientra nel buffer fornito. |
|
Impossibile aprire il file di patch. |
|
La funzione ha avuto esito positivo. |
|
Impossibile aprire il file di patch. |
|
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
Non supportato in Windows Installer 2.0 e versioni precedenti