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.

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

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.

Requisiti

Vedi anche

Non supportato in Windows Installer 2.0 e versioni precedenti

ProductCode