Funzione MsiSourceListSetInfoA (msi.h)
La funzione MsiSourceListSetInfo imposta informazioni sull'elenco di origine per un prodotto o una patch in un contesto specifico.
Sintassi
UINT MsiSourceListSetInfoA(
[in] LPCSTR szProductCodeOrPatchCode,
[in, optional] LPCSTR szUserSid,
[in] MSIINSTALLCONTEXT dwContext,
[in] DWORD dwOptions,
[in] LPCSTR szProperty,
[in] LPCSTR szValue
);
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.
[in] dwContext
Questo parametro specifica il contesto dell'istanza del prodotto o della patch. Questo parametro può contenere uno dei valori seguenti.
[in] dwOptions
Il valore
Se la proprietà impostata è "LastUsedSource", questo parametro specifica anche il tipo di origine come network o URL. In questo caso, il parametro dwOptions
[in] szProperty
Il parametro szProperty indica il valore della proprietà da impostare. Non tutte le proprietà che possono essere recuperate tramite MsiSourceListGetInfo possono essere impostate tramite una chiamata a MsiSourceListSetInfo. Il valore szProperty può essere uno dei valori seguenti.
| Nome | Significato |
|---|---|
|
Percorso relativo alla radice del supporto di installazione. |
|
Modello di richiesta usato quando viene richiesto all'utente di specificare il supporto di installazione. |
|
Percorso di origine usato più di recente per il prodotto. Se l'origine non è registrata, la funzione chiama MsiSourceListAddSourceEx per registrarla. Al termine della registrazione, la funzione imposta l'origine come LastUsedSource. |
|
Nome del pacchetto o della patch di Windows Installer nell'origine. |
[in] szValue
Nuovo valore della proprietà. Non viene eseguita alcuna convalida del nuovo valore. Questo valore non può essere NULL. Può essere una stringa vuota.
Valore restituito
La funzione MsiSourceListSetInfo restituisce i valori seguenti.
| Valore | Significato |
|---|---|
|
L'utente non ha la possibilità di impostare l'elenco di origine per il prodotto specificato. |
|
I dati di configurazione sono danneggiati. |
|
Impossibile accedere al servizio Windows Installer. |
|
Alla funzione è stato passato un parametro non valido. |
|
La proprietà è stata impostata. |
|
La patch non è stata trovata. |
|
Il prodotto non è stato trovato. |
|
Impossibile trovare la proprietà di origine. |
|
Errore interno imprevisto. |
Osservazioni
Gli amministratori possono modificare l'installazione di un prodotto o di un'istanza di patch esistente 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 esistente in qualsiasi 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 dell'altro utente.
Gli utenti non amministratori non possono modificare l'installazione di un prodotto o di un'istanza di patch esistente 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 esistente nel proprio contesto per utente non gestito. Possono modificare l'installazione di un prodotto o 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. Gli utenti possono essere abilitati per cercare le origini impostando i criteri. Per altre informazioni, vedere i criteri diDisableBrowse
Un'eccezione alla regola precedente è l'impostazione di "LastUsedSource" su una delle origini registrate. Se l'origine è già registrata, un non amministratore può impostare "LastUsedSource" sulle proprie installazioni (gestite o non gestite) e sulle installazioni per computer, indipendentemente dai criteri.
Nota
L'intestazione msi.h definisce MsiSourceListSetInfo 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. 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 2.0 e versioni precedenti