Funzione MsiSourceListClearAllExA (msi.h)

Articolo
03/05/2024

La funzione MsiSourceListClearAllEx rimuove tutte le origini esistenti di un determinato tipo di origine per il prodotto o l'istanza di patch specificata. La registrazione della patch viene rimossa anche se l'unica origine della patch viene rimossa e se la patch non viene installata come nuova patch da qualsiasi client nello stesso contesto. Specificando che MsiSourceListClearAllEx rimuove l'origine corrente per questo prodotto o patch forza il programma di installazione a cercare un'origine alla successiva richiesta di un'origine.

Sintassi

UINT MsiSourceListClearAllExA(
  [in]           LPCSTR            szProductCodeOrPatchCode,
  [in, optional] LPCSTR            szUserSid,
  [in]           MSIINSTALLCONTEXT dwContext,
  [in]           DWORD             dwOptions
);

Parametri

[in] szProductCodeOrPatchCode

ProductCode o GUID patch del prodotto o della patch. Usare una stringa con terminazione Null. Se la stringa è più lunga di 39 caratteri, la funzione ha esito negativo e restituisce ERROR_INVALID_PARAMETER. Questo parametro non può essere NULL.

[in, optional] szUserSid

Questo parametro può essere un SID stringa che specifica l'account utente che contiene il prodotto o la patch. Il SID non viene convalidato o risolto. Un SID non corretto può restituire ERROR_UNKNOWN_PRODUCT o ERROR_UNKNOWN_PATCH. Quando si fa riferimento a un contesto del computer, szUserSID deve essere NULL e dwContext deve essere MSIINSTALLCONTEXT_MACHINE. L'utilizzo del SID del computer ("S-1-5-18") restituisce ERROR_INVALID PARAMETER. Quando si fa riferimento all'account utente corrente, szUserSID può essere NULL e dwContext può essere MSIINSTALLCONTEXT_USERMANAGED o MSIINSTALLCONTEXT_USERUNMANAGED.

[in] dwContext

Questo parametro specifica il contesto dell'istanza del prodotto o della patch. Questo parametro può contenere uno dei valori seguenti.

Tipo di contesto	Significato
MSIINSTALLCONTEXT_USERMANAGED	L'istanza del prodotto o della patch esiste nel contesto gestito dall'utente.
MSIINSTALLCONTEXT_USERUNMANAGED	L'istanza del prodotto o della patch esiste nel contesto non gestito per utente.
MSIINSTALLCONTEXT_MACHINE	L'istanza del prodotto o della patch esiste nel contesto per computer.

[in] dwOptions

Il valore dwOptions determina l'interpretazione del valore szProductCodeOrPatchCode e del tipo di origini da cancellare. Questo parametro deve essere una combinazione di una delle costanti MSISOURCETYPE_* seguenti e una delle costanti MSICODE_* seguenti.

Contrassegno	Significato
MSISOURCETYPE_MEDIA	L'origine è un supporto.
MSISOURCETYPE_NETWORK	L'origine è un tipo di rete.
MSISOURCETYPE_URL	L'origine è un tipo di URL.
MSICODE_PATCH	szProductCodeOrPatchCode è un codice patch.
MSICODE_PRODUCT	szProductCodeOrPatchCode è un codice prodotto.

Valore restituito

Valore	Significato
ERROR_ACCESS_DENIED	L'utente non ha la possibilità di aggiungere o spostare un'origine. Non indica se il prodotto o la patch è stato trovato.
ERROR_BAD_CONFIGURATION	I dati di configurazione sono danneggiati.
ERROR_INSTALL_SERVICE_FAILURE	Impossibile accedere al servizio Windows Installer.
ERROR_INVALID_PARAMETER	Alla funzione è stato passato un parametro non valido.
ERROR_SUCCESS	Tutte le origini del tipo specificato sono state rimosse.
ERROR_UNKNOWN_PRODUCT	Il prodotto specificato è sconosciuto.
ERROR_UNKNOWN_PATCH	La patch specificata è sconosciuta.
ERROR_FUNCTION_FAILED	Errore interno imprevisto.

Commenti

Gli amministratori possono modificare l'installazione di un prodotto o di un'istanza di patch presente nel contesto del computer o nel proprio contesto per utente (gestito o non gestito). Possono modificare l'installazione di un prodotto o di un'istanza di patch presente nel contesto gestito dall'utente. Gli amministratori non possono modificare l'installazione di un altro utente di un prodotto o di un'istanza di patch presente nel contesto non gestito di un altro utente.

Gli amministratori non possono modificare l'installazione di un prodotto o di un'istanza di patch presente nel contesto per utente di un altro utente (gestito o non gestito). Possono modificare l'installazione di un prodotto o di un'istanza di patch presente nel proprio contesto per utente non gestito. Possono modificare l'installazione di un prodotto o di un'istanza di patch nel contesto del computer o nel proprio contesto gestito per utente solo se sono abilitati per cercare un prodotto o un'origine patch. È possibile abilitare gli utenti per cercare le origini impostando criteri. Per altre informazioni, vedere DisableBrowse, AllowLockdownBrowse e Criteri AlwaysInstallElevated .

Nota

L'intestazione msi.h definisce MsiSourceListClearAllEx 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 che non è indipendente dalla codifica può causare mancate corrispondenze che generano errori di compilazione o di runtime. Per altre informazioni, vedere Convenzioni per i prototipi di funzioni.

Requisiti

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 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 Windows Installer Run-Time Requirements .See the Windows Installer requirements for information about the minimum Windows Service Pack that is required by a Windows Installer version.
Piattaforma di destinazione	Windows
Intestazione	msi.h
Libreria	Msi.lib
DLL	Msi.dll