Funzione MsiSourceListForceResolutionExA (msi.h)
La funzione MsiSourceListForceResolutionEx rimuove la registrazione della proprietà denominata "LastUsedSource". Questa funzione non influisce sull'elenco di origine registrato. Ogni volta che il programma di installazione richiede l'origine per reinstallare un prodotto o una patch, prova prima l'origine registrata come "LastUsedSource". In caso di errore o se la registrazione non è presente, il programma di installazione cerca le altre origini registrate fino a quando non trova un'origine valida o finché non viene esaurito l'elenco di origini. La cancellazione della registrazione "LastUsedSource" forza il programma di installazione a eseguire una risoluzione di origine rispetto alle origini registrate al successivo utilizzo dell'origine.
Sintassi
UINT MsiSourceListForceResolutionExA(
[in] LPCSTR szProductCodeOrPatchCode,
[in, optional] LPCSTR szUserSid,
[in] MSIINSTALLCONTEXT dwContext,
[in] DWORD dwOptions
);
Parametri
[in] szProductCodeOrPatchCode
GUID ProductCode o 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 di computer, szUserSID deve essere NULL e dwContext deve essere MSIINSTALLCONTEXT_MACHINE. L'uso del SID del computer ("S-1-5-18") restituisce ERROR_INVALID PARAMETRO. 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 di prodotto o patch. Questo parametro può contenere uno dei valori seguenti.
[in] dwOptions
Il valore dwOptions determina l'interpretazione del valore szProductCodeOrPatchCode .
Flag | Significato |
---|---|
|
szProductCodeOrPatchCode è un codice prodotto. |
|
szProductCodeOrPatchCode è un codice patch. |
Valore restituito
La funzione MsiSourceListForceResolutionEx restituisce i valori seguenti.
Valore | Significato |
---|---|
|
L'utente non ha la possibilità di modificare l'elenco di origine specificato. Non indica se è stato trovato il prodotto o la patch. |
|
I dati di configurazione sono danneggiati. |
|
Impossibile accedere al servizio Windows Installer |
|
Un parametro non valido è stato passato alla funzione. |
|
La registrazione "LastUsedSource" è stata cancellata. |
|
La patch non è stata trovata. |
|
Non è stato trovato il prodotto o la patch specificati. |
|
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 per utente per utente non gestito.
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 dall'utente solo se sono abilitati per cercare un prodotto o un'origine patch. Gli utenti possono essere abilitati per cercare le origini impostando criteri, per altre informazioni, vedere DisableBrowse, AllowLockdownBrowse e AlwaysInstallElevated policies.
Nota
L'intestazione msi.h definisce MsiSourceListForceResolutionEx 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 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