Funzione MsiSourceListClearAllA (msi.h)
La funzione MsiSourceListClearAll rimuove tutte le origini di rete dall'elenco di origine di una patch o di un prodotto in un contesto specificato. Per altre informazioni, vedere Resilienza di origine.
Sintassi
UINT MsiSourceListClearAllA(
[in] LPCSTR szProduct,
[in] LPCSTR szUserName,
[in] DWORD dwReserved
);
Parametri
[in] szProduct
Codice ProductCode del prodotto da modificare.
[in] szUserName
Nome utente per un'installazione per utente. Il nome utente deve essere sempre nel formato DOMAIN\USERNAME (o MACHINENAME\USERNAME per un utente locale).
Stringa vuota o NULL per un'installazione per computer.
[in] dwReserved
Riservato per utilizzi futuri. Questo valore deve essere impostato su 0.
Valore restituito
La funzione MsiSourceListClearAll restituisce i valori seguenti.
| Valore | Significato |
|---|---|
|
L'utente non ha la possibilità di cancellare l'elenco di origine per questo prodotto. |
|
I dati di configurazione sono danneggiati. |
|
Impossibile risolvere il nome utente. |
|
La funzione non è riuscita. |
|
Impossibile accedere al servizio di installazione. |
|
Alla funzione è stato passato un parametro non valido. |
|
Funzione completata. |
|
Il prodotto specificato è sconosciuto. |
Commenti
Un amministratore può modificare le installazioni per computer, le proprie installazioni non gestite per utente e le installazioni gestite per utente per qualsiasi utente. Un non amministratore può modificare solo le installazioni per computer e le proprie installazioni (gestite o non gestite) per utente. Gli utenti possono essere abilitati per cercare le origini impostando i criteri. Per altre informazioni, vedere i criteri DisableBrowse, AllowLockdownBrowse e AlwaysInstallElevated .
Se un'origine di rete è l'origine corrente per il prodotto, questa funzione forza il programma di installazione a cercare un'origine valida alla successiva necessità di un'origine. Se l'origine corrente è un supporto o un'origine URL, è ancora valida dopo questa chiamata e l'elenco di origine non viene cercato a meno che non venga chiamato anche MsiSourceListForceResolution .
Se il nome utente è una stringa vuota o NULL, la funzione opera sull'installazione per computer del prodotto. In questo caso, se il prodotto viene installato solo per utente, la funzione restituisce ERROR_UNKNOWN_PRODUCT.
Se il nome utente non è una stringa vuota o NULL, specifica il nome dell'utente di cui viene modificata l'installazione del prodotto. Se il nome utente è il nome utente corrente, la funzione tenta innanzitutto di modificare un'installazione non gestita del prodotto. Se non viene trovata alcuna installazione non gestita del prodotto, la funzione tenta di modificare un'installazione gestita per utente del prodotto. Se non è possibile trovare installazioni gestite o non gestite per utente del prodotto, la funzione restituisce ERROR_UNKNOWN_PRODUCT, anche se il prodotto è installato per computer.
Questa funzione non può modificare un'installazione non gestita per qualsiasi utente oltre all'utente corrente. Se il nome utente non è una stringa vuota o NULL, ma non è l'utente corrente, la funzione controlla solo la presenza di un'installazione gestita per utente del prodotto per l'utente specificato. Se il prodotto non viene installato come gestito per utente per utente specificato, la funzione restituisce ERROR_UNKNOWN_PRODUCT, anche se il prodotto è installato per computer.
Nota
L'intestazione msi.h definisce MsiSourceListClearAll 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
| 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 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 |