Menggunakan API DISM
API Deployment Image Servicing and Management (DISM) memungkinkan Anda membangun solusi yang disesuaikan pada platform DISM. Anda dapat menggunakan API DISM untuk menginstal, menghapus instalan, mengonfigurasi, dan memperbarui fitur, paket, dan driver Windows dalam gambar Windows. DISM dapat digunakan untuk mengelola dan melayani gambar Windows baik dalam format file gambar Windows (.wim) atau file hard drive virtual (.vhd, .vhdx).
Persyaratan
Anda harus menginstal Windows Assessment and Deployment Kit (Windows ADK) di komputer pengembangan Anda untuk membuat aplikasi DISM API:
Solusi anda yang disesuaikan pada platform DISM dikembangkan menggunakan DISM SDK. Ini diinstal ketika Windows ADK diinstal. Untuk informasi selengkapnya tentang sistem operasi yang didukung, lihat Referensi Teknis Penilaian dan Penyebaran Windows (Windows ADK).
Saat menjalankan solusi yang disesuaikan pada platform DISM, Anda harus memverifikasi bahwa versi arsitektur Windows ADK cocok dengan versi arsitektur sistem operasi. Misalnya, solusi khusus yang dikembangkan untuk PC 32-bit berjalan pada Windows versi 32-bit.
Untuk mengembangkan dan menjalankan solusi yang disesuaikan dengan benar pada platform DISM, Anda harus memverifikasi bahwa Anda menggunakan biner DISM dari Windows ADK:
Instal versi terbaru Windows ADK pada PC yang akan menjalankan solusi yang disesuaikan.
File biner untuk solusi yang disesuaikan harus disimpan dalam direktori yang sama dengan biner DISM yang diinstal oleh Windows ADK. Misalnya, biner solusi yang disesuaikan harus terletak di c:\Program Files (x86)\Windows Kits\10\Assessment and Deployment Kit\Deployment Tools\amd64\DISM.
Jalankan solusi yang disesuaikan dari Lingkungan Alat Penyebaran dan Pencitraan sehingga variabel lingkungan yang diperlukan disiapkan sebelum menjalankan solusi Anda.
Dari layar mulai, ketik penyebaran. Klik kanan Lingkungan Alat Penyebaran dan Pencitraan dan pilih Jalankan sebagai administrator.
Catatan Jika Anda tidak menjalankan dari Lingkungan Alat Penyebaran dan Pencitraan, Anda harus memverifikasi bahwa variabel lingkungan PATH menggunakan lokasi biner DISM dari Windows ADK.
Anda akan memerlukan jenis file gambar Windows yang didukung, .wim, .vhd, atau .vhdx, atau instalasi Windows online untuk menggunakan DISMAPI untuk layanan dan manajemen. Beberapa operasi tidak valid pada gambar online. Untuk informasi selengkapnya, lihat Referensi API DISM.
Gambar Target yang Didukung
File gambar Windows yang Anda servis di komputer host Anda dapat berupa file .wim, file .vhd atau .vhdx, atau penginstalan online Windows. Selain itu, layanan lintas arsitektur didukung. Anda dapat melayani gambar x64 dari sistem x86 atau sistem x64. Anda dapat melayani gambar x86 dari sistem x64 atau sistem x86.
Semua fungsi DISMAPI dapat dilakukan pada gambar target Windows 8 dan Windows Server 2012. Untuk melihat apakah fungsi dapat dilakukan pada gambar target lainnya, lihat bagian Persyaratan dari topik referensi fungsi di Referensi API DISM.
Praktik Terbaik
Manajemen memori. Fungsi DISM API tertentu mengembalikan struktur atau array struktur. Struktur ini dikembalikan kepada pengguna sebagai penunjuk ke objek pada heap. Memori heap dialokasikan oleh API DISM. Klien harus memanggil Fungsi DismDelete untuk memastikan bahwa memori ini dirilis.
Memasang VHD dengan alat DiskPart. Jika memungkinkan, Anda harus menggunakan DISM API untuk memasang dan melepas citra yang ingin Anda servis dalam kerangka kerja DISM. Menggunakan alat lain, seperti alat DiskPart, untuk memasang dan melepas citra dapat memiliki efek yang tidak terduga.
Jalur file. Semua jalur yang diterima oleh fungsi DISM API dapat bersifat relatif atau absolut. Sebagai praktik terbaik, batasi panjang jalur file. Jalur file yang terlalu panjang atau melebihi batasan panjang maksimum untuk Windows akan menyebabkan kegagalan dalam DISM.
Mencocokkan panggilan untuk membuka dan menutup sesi. Selalu rilis Sesi DISM dengan menggunakan Fungsi DismCloseSession sebelum memanggil Fungsi DismShutdown. Anda juga dapat melepas gambar dengan Fungsi DismUnmountImage setelah menutup sesi dan sebelum memanggil Fungsi DismShutdown.
Alat DISM lainnya
Untuk informasi selengkapnya tentang platform DISM dan cara lain untuk mengakses fungsionalitas layanan dan manajemen, lihat Referensi Teknis DISM di Referensi Teknis Penilaian dan Penyebaran Windows (Windows ADK). Anda juga dapat menggunakan alat DISM.exe di Windows ADK untuk mengambil gambar sebagai file .wim.