Funzione MsiGetPatchFileListA (msi.h)

Articolo
08/24/2023

La funzione MsiGetPatchFileList viene fornito un elenco di file con estensione msp, delimitati da punti e virgola e recupera l'elenco di file che possono essere aggiornati dalle patch.

Sintassi

UINT MsiGetPatchFileListA(
  [in]      LPCSTR    szProductCode,
  [in]      LPCSTR    szPatchPackages,
  [in, out] LPDWORD   pcFiles,
  [in, out] MSIHANDLE **pphFileRecords
);

Parametri

[in] szProductCode

Valore stringa con terminazione null contenente il GUID ( ProductCode ) del prodotto che è la destinazione delle patch. Questo parametro non può essere NULL.

[in] szPatchPackages

Valore stringa con terminazione null contenente l'elenco delle patch di Windows Installer (file con estensione msp). Ogni patch può essere specificata dal percorso completo del pacchetto di patch. Le patch nell'elenco sono delimitate da punti e virgola. È necessario specificare almeno una patch.

[in, out] pcFiles

Puntatore a un percorso che riceve il numero di file che verranno aggiornati in questo sistema da questo elenco di patch specificate da szPatchList. Questo parametro è obbligatorio.

[in, out] pphFileRecords

Puntatore a una posizione che riceve un puntatore a una matrice di record. Il primo campo (indice 0) di ogni record contiene il percorso completo di un file che può essere aggiornato quando l'elenco di patch in szPatchList viene applicato nel computer. Questo parametro è obbligatorio.

Valore restituito

La funzione MsiGetPatchFileList restituisce i valori seguenti.

Valore	Significato
ERROR_SUCCESS	La funzione è stata completata correttamente.
ERROR_INVALID_PARAMETER	Un parametro non valido è stato passato alla funzione.
ERROR_FUNCTION_FAILED	La funzione non è riuscita.

Commenti

Ad esempio, szPatchList potrebbe avere il valore: "c:\sus\download\cache\Office\sp1.msp; c:\sus\download\cache\Office\QFE1.msp; c:\sus\download\cache\Office\QFEn.msp".

Questa funzione viene eseguita nel contesto del chiamante. Il codice prodotto viene cercato nell'ordine del contesto non gestito dall'utente, nel contesto gestito dall'utente e nel contesto del computer.

È necessario chiudere tutti gli oggetti MSIHANDLE restituiti da questa funzione chiamando la funzione MsiCloseHandle .

Se la funzione ha esito negativo, è possibile ottenere informazioni sull'errore estese usando la funzione MsiGetLastErrorRecord .

Per altre informazioni sull'uso della funzione MsiGetPatchFileList , vedere Elencare i file che possono essere aggiornati.

Nota

L'intestazione msi.h definisce MsiGetPatchFileList 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


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 4.5 in Windows Server 2003 e 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 3.1 e versioni precedenti

Condividi tramite