Funzione MsiSourceListForceResolutionW (msi.h)
La funzione MsiSourceListForceResolution forza il programma di installazione a cercare l'elenco di origine per un'origine prodotto valida alla successiva richiesta di un'origine. Ad esempio, quando il programma di installazione esegue un'installazione o una reinstallazione o quando richiede il percorso di un componente impostato per l'esecuzione dall'origine.
Sintassi
UINT MsiSourceListForceResolutionW(
[in] LPCWSTR szProduct,
[in] LPCWSTR szUserName,
[in] DWORD dwReserved
);
Parametri
[in] szProduct
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 ogni computer.
[in] dwReserved
Riservato per utilizzi futuri. Questo valore deve essere impostato su 0.
Valore restituito
La funzione MsiSourceListForceResolution restituisce i valori seguenti.
| Valore | Significato |
|---|---|
|
Il chiamante non ha accesso sufficiente per forzare la risoluzione del prodotto. |
|
I dati di configurazione sono danneggiati. |
|
L'utente specificato non è un utente valido. |
|
Impossibile completare la funzione. |
|
Impossibile accedere al servizio di installazione. |
|
Un parametro non valido è stato passato alla funzione. |
|
Funzione completata. |
|
Il prodotto specificato è sconosciuto. |
Commenti
Un amministratore può modificare le installazioni per computer, le proprie installazioni non gestite dall'utente e le installazioni gestite per utente per qualsiasi utente. Un amministratore non può modificare solo installazioni per computer e le proprie installazioni (gestite o non gestite) per utente.
Se il nome utente è una stringa vuota o NULL, la funzione opera nell'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 il cui installazione del prodotto viene modificato. Se il nome utente è il nome utente corrente, la funzione tenta prima di tutto di modificare un'installazione non gestita del prodotto. Se non è possibile trovare 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 ogni 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 una 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 ogni computer.
Nota
L'intestazione msi.h definisce MsiSourceListForceResolution 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
| 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 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 |