Fungsi DismUnmountImage
[Beberapa informasi berkaitan dengan produk pra-rilis yang mungkin dimodifikasi secara substansial sebelum dirilis secara komersial. Microsoft tidak memberikan jaminan, tersurat atau tersirat, sehubungan dengan informasi yang diberikan di sini.]
Melepas citra Windows dari lokasi tertentu.
Sintaks
HRESULT WINAPI DismUnmountImage(
_In_ PCWSTR MountPath,
_In_ DWORD Flags,
_In_opt_ HANDLE CancelEvent,
_In_opt_ DISM_PROGRESS_CALLBACK Progress,
_In_opt_ PVOID UserData
);
Parameter
MountPath [in]
Jalur relatif atau absolut ke direktori pemasangan gambar.
Bendera [in]
Bendera lepas yang akan digunakan untuk operasi ini. Untuk informasi selengkapnya tentang melepas bendera, lihat Konstanta API DISM.
CancelEvent [in, opsional]
Pilihan. Anda dapat mengatur CancelEvent untuk fungsi ini untuk membatalkan operasi yang sedang berlangsung saat diberi sinyal oleh klien. Jika CancelEvent diterima pada tahap ketika operasi tidak dapat dibatalkan, operasi akan dilanjutkan dan mengembalikan kode keberhasilan. Jika CancelEvent diterima dan operasi dibatalkan, status gambar tidak diketahui. Anda harus memverifikasi status gambar sebelum melanjutkan atau membuang perubahan dan memulai lagi.
Kemajuan [dalam, opsional]
Opsional. Pointer ke DismProgressCallback yang ditentukan klien.
UserData [in, opsional]
Pilihan. Data kustom yang ditentukan pengguna.
Mengembalikan nilai
Mengembalikan S_OK pada keberhasilan.
Keterangan
Setelah Anda menggunakan DismCloseSession untuk mengakhiri setiap DismSession aktif, Anda dapat melepas citra menggunakan fungsi DismUnmountImage .
Contoh
HRESULT hr = S_OK;
hr = DismMountImage(L"C:\\test\\images\\myimage.wim", L"C:\\test\\offline", 1,
NULL, DismImageIndex, DISM_MOUNT_READWRITE, NULL, NULL, NULL);
hr = DismUnmountImage (L"C:\\test\\offline", DISM_COMMIT_IMAGE, NULL, NULL, NULL);
Persyaratan
| Persyaratan | Deskripsi |
|---|---|
| Platform host yang didukung untuk gambar WIM | DISM API dapat digunakan pada sistem operasi apa pun yang didukung oleh Windows Assessment and Deployment Kit (Windows ADK). Untuk informasi selengkapnya, lihat Referensi Teknis Windows ADK |
| Platform host yang didukung untuk gambar VHD | 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 |
| Klien minimum yang didukung | Windows 7 [hanya aplikasi desktop] |
| Server minimum yang didukung | Windows Server 2008 R2 [hanya aplikasi desktop] |
| Header | DismAPI.h |
| Pustaka | DismAPI.lib |
| DLL | DismAPI.dll |