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
| Bandiera | 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
Il 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 alla richiesta del nuovo disco. Passando un null o una stringa vuota per szVolumeLabel registra una stringa vuota (0 byte) come etichetta del volume.
[in, optional] szDiskPrompt
Nella voce per MsiSourceListAddMediaDisk, szDiskPrompt fornisce la richiesta del disco da aggiungere o aggiornare. Un aggiornamento sovrascrive il prompt del disco registrato.
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. Passando NULL o una stringa vuota registra una stringa vuota (0 byte di lunghezza) come richiesta del disco.
Valore restituito
La funzione msiSourceListAddMediaDisk
| Valore | Significato |
|---|---|
|
L'utente non ha la possibilità di leggere l'origine multimediale specificata o il prodotto o la patch specificati. Ciò 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. |
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 DisableBrowse, AllowLockdownBrowse, AllowLockDownMedia e AlwaysInstallElevated criteri.
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 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 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 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