Condividi tramite

Creazione di un'applicazione DISM

  • Articolo

È possibile sviluppare applicazioni usando l'API DISM in qualsiasi computer in cui è stato installato Windows Assessment and Deployment Kit (Windows ADK).

Configurazione dell'ambiente di sviluppo

  1. Aggiungere il percorso a DismApi.lib come dipendenza aggiuntiva nelle proprietà di input del linker del progetto.

    Per impostazione predefinita, DismApi.lib viene installato con Windows ADK in C:\Programmi (x86)\Windows Kits\8.0\Assessment and Deployment Kit\Deployment Kit\Deployment and Imaging Tools\SDK\DismApi\Lib\.

  2. Aggiungere il percorso a DismApi.h alle proprietà della risorsa del progetto.

    Per impostazione predefinita, DismApi.h viene installato con Windows ADK in C:\Programmi (x86)\Windows Kits\8.0\Assessment and Deployment Kit\Deployment Kit\Deployment and Imaging Tools\SDK\DismApi\Include\.

  3. Includere il file di intestazione dell'API DISM, DismApi.h, nel codice.

Funzioni API DISM necessarie

Tutti i processi API DISM devono iniziare con la funzione DismInitialize prima di eseguire altre chiamate all'API DISM. Al contrario, la funzione DismShutdown viene usata per terminare un processo.

Per eseguire il servizio di un'immagine offline, usare la funzione DismMountImage per eseguire il mapping del contenuto dell'immagine a una directory nel computer locale prima di aprire una sessione DISM.

È possibile associare un'immagine di Windows offline o online a una diSMSession chiamando la funzione DismOpenSession. Tutte le operazioni di manutenzione e riparazione sulle immagini vengono eseguite usando un DISMSession. Tutte le API che operano su un'immagine accettano un Oggetto DismSession come primo parametro. È possibile chiamare la funzione DismCloseSession per rilasciare un oggetto DismSession e quindi chiamare la funzione DismUnmountImage se si usa l'immagine offline.

Alcune operazioni non richiedono una sessione DISM. Tra cui la funzione DismGetImageInfo, DismGetMountedImageInfo, Funzione DismRemountImage, Funzione DismCleanupMountpoints, Funzione DismGetLastErrorMessage e Funzione DismDelete. Queste operazioni possono essere usate in qualsiasi momento dopo la chiamata della funzione DismInitialize .

Per un esempio di applicazione DISM di base, vedere Esempi di API DISM.

Usare le API DISM associate per aprire e chiudere i processi

  1. Per avviare un processo DISM, chiamare la funzione DismInitialize.

  2. Se si usa un'immagine offline, chiamare la funzione DismMountImage.

  3. È possibile chiamare tutte le funzioni che non richiedono una sessione DISM, ad esempio Funzione DismGetMountedImageInfo, dopo aver avviato il processo con la funzione DismInitialize.

  4. Se si vuole eseguire il servizio di un'immagine, associare prima di tutto un'immagine di Windows offline o online a una funzione DISMSession chiamando la funzione DismOpenSession.

  5. È ora possibile eseguire operazioni di gestione o manutenzione delle immagini che usano una sessione DISM, ad esempio la funzione DismAddPackage.

    Per altre informazioni sulle funzioni disponibili, vedere Funzioni API DISM.

  6. Salvare le modifiche usando la funzione DismCommitImage.

  7. Se sono presenti sessioni aperte, usare la funzione DismCloseSession per ognuna per rilasciare la sessione e liberare la memoria allocata.

  8. Se si usa un'immagine offline, chiamare la funzione DismUnmountImage per rimuovere l'immagine montata dal computer locale.

  9. Per chiudere il processo, usare la funzione DismShutdown.

Esempi di API DISM