Uso dell'API DISM
L'API Gestione e manutenzione immagini distribuzione consente di creare soluzioni personalizzate nella piattaforma DISM. È possibile usare l'API DISM per installare, disinstallare, configurare e aggiornare funzionalità, pacchetti e driver di Windows in un'immagine di Windows. È possibile usare DISM per gestire e supportare le immagini di Windows nel formato di file immagine windows (con estensione wim) o nel file disco rigido virtuale (con estensione vhd, vhdx).
Requisiti
È necessario installare Windows Assessment and Deployment Kit (Windows ADK) nel computer di sviluppo per creare applicazioni API DISM:
Le soluzioni personalizzate nella piattaforma DISM vengono sviluppate usando DISM SDK. Questa operazione viene installata quando è installato Windows ADK. Per altre informazioni sui sistemi operativi supportati, vedere Informazioni di riferimento tecnico su Windows Assessment and Deployment Kit (Windows ADK).
Quando si eseguono soluzioni personalizzate nella piattaforma DISM, è necessario verificare che la versione dell'architettura di Windows ADK corrisponda alla versione dell'architettura del sistema operativo. Ad esempio, una soluzione personalizzata sviluppata per pc a 32 bit viene eseguita nella versione a 32 bit di Windows.
Per sviluppare ed eseguire correttamente le soluzioni personalizzate nella piattaforma DISM, è necessario verificare di usare i file binari DISM da Windows ADK:
Installare la versione più recente di Windows ADK nel PC che eseguirà la soluzione personalizzata.
I file binari per le soluzioni personalizzate devono essere salvati nella stessa directory dei file binari DISM installati da Windows ADK. Ad esempio, i file binari personalizzati delle soluzioni devono trovarsi in c:\Programmi (x86)\Windows Kits\10\Assessment and Deployment Kit\Deployment Tools\amd64\DISM.
Eseguire le soluzioni personalizzate dall'ambiente strumenti di distribuzione e creazione immagini in modo che le variabili di ambiente necessarie vengano configurate prima di eseguire le soluzioni.
Nella schermata iniziale digitare la distribuzione. Fai clic con il pulsante destro del mouse su Ambiente degli strumenti di distribuzione e creazione immagini e quindi scegli Esegui come amministratore.
Nota Se non si esegue dall'ambiente strumenti di distribuzione e creazione immagini, è necessario verificare che la variabile di ambiente PATH usi il percorso dei file binari DISM da Windows ADK.
È necessario un tipo di file di immagine di Windows supportato, wim, vhd o vhdx o un'installazione online di Windows per usare DISMAPI per la manutenzione e la gestione. Alcune operazioni non sono valide nelle immagini online. Per altre informazioni, vedere Informazioni di riferimento sull'API DISM.
Immagini di destinazione supportate
Il file di immagine di Windows di cui si sta eseguendo la manutenzione nel computer host può essere un file con estensione wim, un file vhd o vhdx o un'installazione online di Windows. È inoltre supportata la manutenzione tra architetture. È possibile eseguire il servizio di un'immagine x64 da un sistema x86 o da un sistema x64. È possibile eseguire il servizio di un'immagine x86 da un sistema x64 o da un sistema x86.
Tutte le funzioni DISMAPI possono essere eseguite su Windows 8 e Windows Server 2012 immagini di destinazione. Per verificare se è possibile eseguire una funzione su altre immagini di destinazione, vedere la sezione Requisiti dell'argomento di riferimento alla funzione nella guida di riferimento alle API DISM.
Procedure consigliate
Gestione della memoria. Alcune funzioni API DISM restituiscono strutture o matrici di strutture. Queste strutture vengono restituite all'utente come puntatore a un oggetto nell'heap. La memoria heap viene allocata dall'API DISM. Il client deve chiamare la funzione DismDelete per assicurarsi che questa memoria venga rilasciata.
Montaggio di un disco rigido virtuale con lo strumento DiskPart. Quando possibile, è consigliabile usare l'API DISM per montare e smontare le immagini che si desidera eseguire nel framework DISM. L'uso di un altro strumento, ad esempio lo strumento DiskPart, per montare e smontare l'immagine può avere effetti imprevisti.
Percorsi di file. Tutti i percorsi accettati dalle funzioni API DISM possono essere relativi o assoluti. Come procedura consigliata, limitare la lunghezza dei percorsi di file. I percorsi di file troppo lunghi o superano la limitazione massima di lunghezza per Windows causano errori nel servizio di gestione delle risorse di archiviazione.
Chiamate corrispondenti per aprire e chiudere le sessioni. Rilasciare sempre una sessione DISM usando la funzione DismCloseSession prima di chiamare la funzione DismShutdown. È anche possibile smontare l'immagine con la funzione DismUnmountImage dopo aver chiuso la sessione e prima di chiamare la funzione DismShutdown.
Altri strumenti DISM
Per altre informazioni sulla piattaforma DISM e su altri modi per accedere alla funzionalità di manutenzione e gestione, vedere Informazioni di riferimento tecnico DISM nella Guida di riferimento tecnico di Windows Assessment and Deployment Kit (Windows ADK). È anche possibile usare lo strumento DISM.exe in Windows ADK per acquisire un'immagine come file con estensione wim.
Argomenti correlati
Creazione di un'applicazione DISM
Risoluzione dei problemi relativi alle API DISM