Funzione MsiSourceListAddSourceExA (msi.h)

La funzione MsiSourceListAddSourceEx aggiunge o riordina il set di origini di una patch o di un prodotto in un contesto specificato. Può anche creare un elenco di origine per una patch che non esiste nel contesto specificato.

Sintassi

UINT MsiSourceListAddSourceExA(
  [in]           LPCSTR            szProductCodeOrPatchCode,
  [in, optional] LPCSTR            szUserSid,
  [in]           MSIINSTALLCONTEXT dwContext,
  [in]           DWORD             dwOptions,
  [in]           LPCSTR            szSource,
  [in, optional] DWORD             dwIndex
);

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.

[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 e il tipo di origini da cancellare. Questo parametro deve essere una combinazione di una delle costanti MSISOURCETYPE_ seguenti e una delle costanti MSICODE_ seguenti.

[in] szSource

Origine da aggiungere o spostare. Questo parametro deve contenere solo il percorso senza il nome file. Il nome file è già registrato come "PackageName" e può essere modificato tramite MsiSourceListSetInfo. Questo argomento è obbligatorio.

[in, optional] dwIndex

Questo parametro fornisce il nuovo indice per l'origine. Tutte le origini vengono indicizzate nell'elenco di origine da 1 a N, dove N è il conteggio delle origini nell'elenco. Ogni origine nell'elenco ha un indice univoco.

Se MsiSourceListAddSourceEx viene chiamato con una nuova origine e dwIndex impostata su 0 (zero), la nuova origine viene aggiunta all'elenco esistente. Se dwIndex è impostato su 0 e l'origine esiste già nell'elenco, non viene eseguito alcun aggiornamento nell'elenco.

Se MsiSourceListAddSourceEx viene chiamato con una nuova origine e dwIndex impostata su un valore diverso da zero (N), la nuova origine viene inserita nell'indice specificato e le altre origini vengono ri indicizzate. Se l'origine esiste già, viene spostata nell'indice specificato e le altre origini vengono ri indicizzate.

Se MsiSourceListAddSourceEx viene chiamato con una nuova origine e dwIndex impostata su un valore diverso da zero rispetto al numero di origini (N), la nuova origine viene aggiunta all'elenco esistente. Se l'origine esiste già, viene spostata alla fine dell'elenco e le altre origini vengono ri indicizzate.

Valore restituito

La funzione MsiSourceListAddSourceEx restituisce i valori seguenti.

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 i criteri. Per altre informazioni, vedere i criteri DisableBrowse, AllowLockdownBrowse e AlwaysInstallElevated .

Requisiti

Vedi anche

AllowLockdownBrowse

AlwaysInstallElevated

DisableBrowse

MsiSourceListSetInfo

Non supportato in Windows Installer 2.0 e versioni precedenti

ProductCode

Resilienza di origine