Funzione DismEnableFeature
Abilita una funzionalità in un'immagine. Le funzionalità sono identificate da un nome e possono essere facoltativamente associate a un pacchetto.
Sintassi
HRESULT WINAPI DismEnableFeature(
_In_ DismSession Session,
_In_ PCWSTR FeatureName,
_In_opt_ PCWSTR Identifier,
_In_opt_ DismPackageIdentifier PackageIdentifier,
_In_ BOOL LimitAccess,
_In_opt_ PCWSTR *SourcePaths,
_In_opt_ UINT SourcePathCount,
_In_ BOOL EnableAll,
_In_opt_ HANDLE CancelEvent,
_In_opt_ DISM_PROGRESS_CALLBACK Progress,
_In_opt_ PVOID UserData
);
Parametri
Sessione [in]
Una dismSession valida. La dismSession deve essere associata a un'immagine. È possibile associare una sessione a un'immagine usando DismOpenSession.
FeatureName [in]
Nome della funzionalità abilitata. Per abilitare più funzionalità, separare ogni nome di funzionalità con un punto e virgola.
Identificatore [in, facoltativo]
Facoltativa. Percorso assoluto di un file .cab o del nome del pacchetto padre della funzionalità da abilitare.
PackageIdentifier [in, facoltativo]
Facoltativa. Valore di enumerazione DismPackageIdentifier valido. È consigliabile usare DismPackageName quando il parametro Identifier punta a un nome del pacchetto e Quando Identifier punta al percorso assoluto di un file di .cab, è necessario usare DismPackagePath. Se il campo Identificatore non è NULL, è necessario specificare un parametro PackageIdentifier valido. Se il campo Identificatore è NULL, il parametro PackageIdentifier viene ignorato.
LimitAccess [in]
Questo parametro viene ignorato a partire da Windows 8.1 e Windows Server 2012 R2.
Windows 8 e Windows Server 2012:
Valore booleano che indica se Windows Update (WU) deve essere contattato come percorso di origine per il download dei file se nessuno viene trovato in altri percorsi specificati. Prima di controllare WU, gestione e manutenzione immagini distribuzione verificherà la presenza dei file nei Percorsi di origine forniti e in tutti i percorsi specificati nel Registro di sistema in base ai criteri di gruppo. Se i file necessari per abilitare la funzionalità sono ancora presenti nel computer, questo flag viene ignorato.
| Valore | Descrizione |
|---|---|
| TRUE | Non controllare wu per i file di ripristino. |
| FALSE | Valore predefinito. Controllare wu per i file di ripristino. |
SourcePaths [in, facoltativo]
Questo parametro viene ignorato a partire da Windows 8.1 e Windows Server 2012 R2.
Windows 8 e Windows Server 2012:
Elenco dei percorsi di origine per verificare la presenza di file necessari per abilitare la funzionalità.
SourcePathCount [in, facoltativo]
Questo parametro viene ignorato a partire da Windows 8.1 e Windows Server 2012 R2.
Windows 8 e Windows Server 2012:
Numero di percorsi di origine specificati.
EnableAll [in]
Abilitare tutte le dipendenze della funzionalità. Se la funzionalità specificata o una delle relative dipendenze non può essere abilitata, nessuna di esse verrà modificata rispetto allo stato esistente.
| Valore | Descrizione |
|---|---|
| TRUE | Abilitare tutte le dipendenze della funzionalità. |
| FALSE | Abilitare solo la funzionalità specificata. |
CancelEvent [in, facoltativo]
Facoltativa. È possibile impostare un CancelEvent per questa funzione per annullare l'operazione in corso quando viene segnalato dal client. Se l'evento CancelEvent viene ricevuto in una fase quando l'operazione non può essere annullata, l'operazione continuerà e restituirà un codice di operazione riuscita. Se l'evento CancelEvent viene ricevuto e l'operazione viene annullata, lo stato dell'immagine è sconosciuto. È necessario verificare lo stato dell'immagine prima di continuare o annullare le modifiche e ricominciare.
Stato [in, facoltativo]
Facoltativa. Puntatore a un dismProgressCallback definito dal client.
UserData [in, facoltativo]
Facoltativa. Dati personalizzati definiti dall'utente.
Valore restituito
Se l'esito è positivo, restituisce S_OK .
Commenti
Se la funzionalità è presente nel pacchetto di base, non è necessario specificare alcuna informazione sul pacchetto. Se la funzionalità si trova in un pacchetto facoltativo o in un Feature Pack già installato nell'immagine, specificare un nome del pacchetto nel parametro Identifier e specificare DismPackageName come PackageIdentifier. Se la funzionalità non può essere abilitata a causa della mancata abilitazione della funzionalità padre, verrà restituito un codice di errore speciale. È possibile usare EnableAll per abilitare le funzionalità padre quando si abilitano le funzionalità specificate oppure è possibile usare DismGetFeatureParent per enumerare le funzionalità padre e abilitarle per prime.
Importante
Se la funzionalità da abilitare non è un componente del pacchetto di base, è necessario aggiungere il pacchetto facoltativo padre con DismAddPackage prima di abilitare la funzionalità. Non specificare un percorso di un file di .cab di un pacchetto facoltativo che non è stato aggiunto all'immagine nel parametro Identifier . Se si specifica un pacchetto che non è stato aggiunto e si specifica DismPackagePath come PackageIdentifier, la funzione verrà completata correttamente, ma la funzionalità non verrà abilitata.
Nota
LimitAccess, SourcePaths, SourcePathCount e EnableAll sono supportati solo in Windows 8 e Windows Server 2012.
Esempio
HRESULT hr = S_OK;
hr = DismEnableFeature(Session, “WindowsMediaPlayer”, NULL, PackageNone, TRUE, NULL, 0, FALSE, NULL, NULL, NULL);
Requisiti
| Requisito | Descrizione |
|---|---|
| Piattaforme host supportate | L'API GESTIONE e manutenzione immagini distribuzione può essere usata in qualsiasi sistema operativo supportato da Windows Assessment and Deployment Kit (Windows ADK). Per altre informazioni, vedere la Guida tecnica di Windows ADK. |
| Piattaforme di immagini supportate | Windows 7, Windows Server 2008 R2, Windows PE 3.0, Windows 8, Windows Server 2012, Windows Preinstallation Environment (Windows PE) 4.0, Windows 8.1, Windows Server 2012 R2, Windows 10, Windows Server 2016 |
| Client minimo supportato | Windows 7 [solo app desktop] |
| Server minimo supportato | Windows Server 2008 R2 [solo app desktop] |
| Intestazione | DismAPI.h |
| Libreria | DismAPI.lib |
| DLL | DismAPI.dll |