Funzione MsiSourceListAddMediaDiskA (msi.h)
La funzione MsiSourceListAddMediaDisk aggiunge o aggiorna un disco dell'origine multimediale di un prodotto o di una patch registrata. Se il disco specificato esiste già, viene aggiornato con i nuovi valori. Se il disco specificato non esiste, viene creata una nuova voce del disco con i nuovi valori.
Sintassi
UINT MsiSourceListAddMediaDiskA(
[in] LPCSTR szProductCodeOrPatchCode,
[in, optional] LPCSTR szUserSid,
[in] MSIINSTALLCONTEXT dwContext,
[in] DWORD dwOptions,
[in] DWORD dwDiskId,
[in] LPCSTR szVolumeLabel,
[in, optional] LPCSTR szDiskPrompt
);
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.
[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 dwOptions specifica il significato di szProductCodeOrPatchCode.
| Flag | Significato |
|---|---|
|
szProductCodeOrPatchCode è un GUID del codice prodotto. |
|
szProductCodeOrPatchCode è un GUID del codice patch. |
[in] dwDiskId
Questo parametro fornisce l'ID del disco da aggiungere o aggiornare.
[in] szVolumeLabel
SzVolumeLabel fornisce l'etichetta del disco da aggiungere o aggiornare. Un aggiornamento sovrascrive l'etichetta del volume esistente nel Registro di sistema. Per modificare solo il prompt del disco, ottenere l'etichetta del volume esistente dal Registro di sistema e specificarla in questa chiamata insieme al nuovo prompt del disco. Passando una stringa NULL o vuota per szVolumeLabel registra una stringa vuota (0 byte di lunghezza) come etichetta del volume.
[in, optional] szDiskPrompt
Quando si accede a MsiSourceListAddMediaDisk, szDiskPrompt fornisce la richiesta del disco da aggiungere o aggiornare. Un aggiornamento sovrascrive il prompt dei dischi registrati.
Per modificare solo l'etichetta del volume, ottenere il prompt del disco esistente registrato e specificarlo quando si chiama MsiSourceListAddMediaDisk insieme alla nuova etichetta del volume. Il passaggio di NULL o una stringa vuota registra una stringa vuota (0 byte di lunghezza) come richiesta del disco.
Valore restituito
La funzione MsiSourceListAddMediaDisk restituisce i valori seguenti.
| Valore | Significato |
|---|---|
|
L'utente non ha la possibilità di leggere l'origine multimediale specificata o il prodotto o la patch specificati. Questo non indica se è stata trovata un'origine multimediale, un prodotto o una patch. |
|
I dati di configurazione sono danneggiati. |
|
Impossibile accedere al servizio Windows Installer. |
|
Alla funzione è stato passato un parametro non valido. |
|
Il valore è stato riordinato correttamente. |
|
La patch non è stata trovata. |
|
Il prodotto non è stato trovato. |
|
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 non gestito di un altro utente.
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 DisableBrowse, AllowLockdownBrowse, AllowLockDownMedia e AlwaysInstallElevated policies.For more information, see DisableBrowse, AllowLockdownBrowse, AllowLockDownMedia and AlwaysInstallElevated policies.
Nota
L'intestazione msi.h definisce MsiSourceListAddMediaDisk 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
| 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 3.0 o versione successiva in Windows Server 2003 o Windows XP. 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
Non supportato in Windows Installer 2.0 e versioni precedenti
Commenti e suggerimenti
Presto disponibile: Nel corso del 2024 verranno gradualmente disattivati i problemi di GitHub come meccanismo di feedback per il contenuto e ciò verrà sostituito con un nuovo sistema di feedback. Per altre informazioni, vedere https://aka.ms/ContentUserFeedback.
Invia e visualizza il feedback per