Funzione MsiSourceListAddSourceA (msi.h)

Articolo
11/20/2024

La funzione msiSourceListAddSource aggiunge all'elenco di origini di rete valide che contengono il tipo specificato di origini per un prodotto o una patch in un contesto utente specificato.

Il numero di origini nella proprietà SOURCELIST è illimitato.

Sintassi

UINT MsiSourceListAddSourceA(
  [in] LPCSTR szProduct,
  [in] LPCSTR szUserName,
  [in] DWORD  dwReserved,
  [in] LPCSTR szSource
);

Parametri

[in] szProduct

ProductCode del prodotto da modificare.

[in] szUserName

Nome utente per un'installazione per utente. In Windows 2000 o Windows XP, 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 computer.

[in] dwReserved

Riservato per uso futuro. Questo valore deve essere impostato su 0.

[in] szSource

Puntatore alla stringa che specifica l'origine.

Valore restituito

Codice restituito	Descrizione
ERROR_ACCESS_DENIED	L'utente non ha la possibilità di aggiungere un'origine.
ERROR_BAD_CONFIGURATION	I dati di configurazione sono danneggiati.
ERROR_BAD_USERNAME	Impossibile risolvere il nome utente.
ERROR_FUNCTION_FAILED	La funzione non è riuscita.
ERROR_INSTALL_SERVICE_FAILURE	Impossibile accedere al servizio di installazione.
ERROR_INVALID_PARAMETER	Alla funzione è stato passato un parametro non valido.
ERROR_SUCCESS	L'origine è stata aggiunta.
ERROR_UNKNOWN_PRODUCT	Il prodotto specificato è sconosciuto.

Osservazioni

Un amministratore può modificare le installazioni per computer, le proprie installazioni per utente non gestite e le installazioni gestite per utente per ogni utente. Un non amministratore può modificare solo le installazioni per computer e le proprie installazioni (gestite o non gestite) per utente. Gli utenti possono essere abilitati per cercare le origini impostando i criteri. Per altre informazioni, vedere i criteri diDisableBrowse , AllowLockdownBrowsee AlwaysInstallElevated.

Si noti che questa funzione aggiunge semplicemente la nuova origine all'elenco di origini valide. Se è stata usata un'altra origine per installare il prodotto, la nuova origine non viene usata fino a quando l'origine corrente non è disponibile.

È responsabilità del chiamante assicurarsi che l'origine fornita sia un'immagine di origine valida per il prodotto.

Se il nome utente è una stringa vuota o NULL, la funzione opera sull'installazione per computer del prodotto. In questo caso, se il prodotto viene installato solo nello stato per utente, la funzione restituisce ERROR_UNKNOWN_PRODUCT.

Se il nome utente non è una stringa vuota o NULL, specifica il nome dell'utente di cui viene modificata l'installazione del prodotto. 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 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 l'installazione gestita per utente del prodotto per l'utente specificato. Se il prodotto non è installato come gestito per utente per l'utente specificato, la funzione restituisce ERROR_UNKNOWN_PRODUCT, anche se il prodotto è installato per computer.

Nota

L'intestazione msi.h definisce MsiSourceListAddSource 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. 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 Requisiti di windows Run-Time.
piattaforma di destinazione	Finestre
intestazione	msi.h
libreria	Msi.lib
dll	Msi.dll