Funzione MsiGetPatchFileListA (msi.h)

Articolo
11/20/2024

La funzione msiGetPatchFileList viene fornito un elenco di file 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 ProductCode (GUID) del prodotto che rappresenta la destinazione delle patch. Questo parametro non può essere NULL.

[in] szPatchPackages

Valore stringa con terminazione Null che contiene l'elenco di patch di Windows Installer (file con estensione msp). Ogni patch può essere specificata dal percorso completo del pacchetto 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 viene applicato l'elenco delle patch in szPatchList. Questo parametro è obbligatorio.

Valore restituito

La funzione msiGetPatchFileList restituisce i valori seguenti.

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

Osservazioni

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 di contesto utente non gestito, contesto gestito dall'utente e 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 estese sull'errore usando la funzione msiGetLastErrorRecord .

Per altre informazioni sull'uso della funzione msiGetPatchFileList , vedere Elenco dei 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 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 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 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 3.1 e versioni precedenti

Condividi tramite