Funzione MsiSourceListClearMediaDiskA (msi.h)

Articolo
02/29/2024

La funzione MsiSourceListClearMediaDisk consente di rimuovere un disco registrato esistente nell'origine multimediale per un prodotto o una patch in un contesto specifico.

Sintassi

UINT MsiSourceListClearMediaDiskA(
  [in]           LPCSTR            szProductCodeOrPatchCode,
  [in, optional] LPCSTR            szUserSid,
  [in]           MSIINSTALLCONTEXT dwContext,
  [in]           DWORD             dwOptions,
  [in]           DWORD             dwDiskId
);

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.

Tipo di SID	Significato
NULL	NULL indica l'utente attualmente connesso. Quando si fa riferimento all'account utente corrente, szUserSID può essere NULL e dwContext può essere MSIINSTALLCONTEXT_USERMANAGED o MSIINSTALLCONTEXT_USERUNMANAGED.
SID utente	Specifica l'enumerazione per un determinato utente nel sistema. Un esempio di SID utente è "S-1-3-64-2415071341-1358098788-3127455600-2561".

Nota Non è possibile usare la speciale stringa SID s-1-5-18 (sistema) per enumerare prodotti o patch installati in base al computer. L'impostazione del valore SID su s-1-5-18 restituisce ERROR_INVALID_PARAMETER. Quando dwContext è impostato solo su MSIINSTALLCONTEXT_MACHINE, szUserSid deve essere NULL.

Nota La stringa SID speciale s-1-1-0 (tutti) non deve essere usata. L'impostazione del valore SID su s-1-1-0 ha esito negativo e restituisce ERROR_INVALID_PARAM.

[in] dwContext

Questo parametro specifica il contesto dell'istanza del prodotto o della patch. Questo parametro può contenere uno dei valori seguenti.

Tipo di contesto	Significato
MSIINSTALLCONTEXT_USERMANAGED	L'istanza del prodotto o della patch esiste nel contesto gestito dall'utente.
MSIINSTALLCONTEXT_USERUNMANAGED	L'istanza del prodotto o della patch esiste nel contesto non gestito per utente.
MSIINSTALLCONTEXT_MACHINE	L'istanza del prodotto o della patch esiste nel contesto per computer.

[in] dwOptions

Il valore dwOptions specifica il significato di szProductCodeOrPatchCode.

Contrassegno	Significato
MSICODE_PRODUCT	szProductCodeOrPatchCode è un GUID del codice prodotto.
MSICODE_PATCH	szProductCodeOrPatchCode è un GUID del codice patch.

[in] dwDiskId

Questo parametro fornisce l'ID del disco da rimuovere.

Valore restituito

La funzione MsiSourceListClearMediaDisk restituisce i valori seguenti.

Valore	Significato
ERROR_ACCESS_DENIED	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.
ERROR_BAD_CONFIGURATION	I dati di configurazione sono danneggiati.
ERROR_INSTALL_SERVICE_FAILURE	Impossibile accedere al servizio Windows Installer.
ERROR_INVALID_PARAMETER	Alla funzione è stato passato un parametro non valido.
ERROR_SUCCESS	Il valore è stato rimosso o non è stato trovato.
ERROR_UNKNOWN_PATCH	La patch non è stata trovata.
ERROR_UNKNOWN_PRODUCT	Il prodotto non è stato trovato.
ERROR_FUNCTION_FAILED	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 i criteri DisableBrowse, AllowLockdownBrowse e AlwaysInstallElevated .

Nota

L'intestazione msi.h definisce MsiSourceListClearMediaDisk 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

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

ProductCode

Condividi tramite