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

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.

Tipo di SID Significato
NULL
NULL indica l'utente attualmente connesso. Quando si fa riferimento all'account utente corrente, szUserSID può essere NULL e dwContext può essere MSIINSTALLCONTEXT_USERMANAGED o MSIINSTALLCONTEXT_USERUNMANAGED.
SID utente
Specifica l'enumerazione per un determinato utente nel sistema. Un esempio di SID utente è "S-1-3-64-2415071341-1358098788-312745600-2561".
 
Nota Impossibile usare la stringa SID speciale "S-1-5-18" (sistema) per enumerare i prodotti o le patch installate come per computer. L'impostazione del valore SID su "S-1-5-18" restituisce "ERROR_INVALID_PARAMETER".
 
Nota La stringa SID speciale "S-1-1-0" (tutti) non deve essere usata. L'impostazione del valore SID su "S-1-1-0" ha esito negativo e restituisce ERROR_INVALID_PARAM.
 

[in] dwContext

Questo parametro specifica il contesto dell'istanza di prodotto o 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 di prodotto o patch esiste nel contesto per utente non gestito.
MSIINSTALLCONTEXT_MACHINE
L'istanza di prodotto o patch esiste nel contesto per computer.

[in] dwOptions

Il valore dwOptions specifica il significato di szProductCodeOrPatchCode.

Se la proprietà impostata è "LastUsedSource", questo parametro specifica anche il tipo di origine come rete o URL. In questo caso, il parametro dwOptions deve essere una combinazione di una delle costanti MSISOURCETYPE_ seguenti e una delle costanti di MSICODE_ seguenti.

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

[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
INSTALLPROPERTY_MEDIAPACKAGEPATH
"MediaPackagePath"
Percorso relativo alla radice del supporto di installazione.
INSTALLPROPERTY_DISKPROMPT
"DiskPrompt"
Modello di prompt usato quando viene richiesto all'utente di installare il supporto di installazione.
INSTALLPROPERTY_LASTUSEDSOURCE
"LastUsedSource"
Posizione di origine usata 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.
INSTALLPROPERTY_PACKAGENAME
"PackageName"
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
ERROR_ACCESS_DENIED
L'utente non ha la possibilità di impostare l'elenco di origine per il prodotto specificato.
ERROR_BAD_CONFIGURATION
I dati di configurazione sono danneggiati.
ERROR_INSTALL_SERVICE_FAILURE
Impossibile accedere al servizio Windows Installer.
ERROR_INVALID_PARAMETER
Un parametro non valido è stato passato alla funzione.
ERROR_SUCCESS
La proprietà è stata impostata.
ERROR_UNKNOWN_PATCH
La patch non è stata trovata.
ERROR_UNKNOWN_PRODUCT
Il prodotto non è stato trovato.
ERROR_UNKNOWN_PROPERTY
La proprietà di origine non è stata trovata.
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 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 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 DisableBrowse, AllowLockdownBrowse e AlwaysInstallElevated .

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 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. 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

Vedi anche

Contesto di installazione

MsiSourceListGetInfo

Non supportato in Windows Installer 2.0 e versioni precedenti

ProductCode