Fungsi DismOpenSession
Mengaitkan gambar Windows offline atau online dengan DISMSession.
Sintaks
HRESULT WINAPI DismOpenSession(
_In_ PCWSTR ImagePath,
_In_opt_ PCWSTR WindowsDirectory,
_In_opt_ PCWSTR SystemDrive,
_Out_ DismSession *Session
);
Parameter
ImagePath [in]
Atur ImagePath ke salah satu nilai berikut:
- Jalur absolut atau relatif ke direktori akar gambar Windows offline.
- Jalur absolut atau relatif ke direktori akar gambar Windows yang dipasang. Anda dapat memasang gambar sebelum memanggil DismOpenSession dengan menggunakan alat eksternal atau dengan menggunakan DismMountImage.
- DISM_ONLINE_IMAGE untuk mengaitkan Sesi dengan penginstalan Windows online.
WindowsDirectory [in, opsional]
Pilihan. Jalur relatif atau absolut ke direktori Windows. Jalur relatif terhadap titik pemasangan.
Jika nilai WindowsDirectory adalah NULL, nilai default "Windows" digunakan.
Parameter WindowsDirectory tidak dapat digunakan ketika parameter ImagePath diatur ke DISM_ONLINE_IMAGE.
SystemDrive [in, opsional]
Opsional. Huruf drive sistem yang berisi manajer boot. Jika SystemDriveNULL, nilai default drive yang berisi titik pemasangan akan digunakan.
Parameter SystemDrive tidak dapat digunakan saat parameter ImagePath diatur ke DISM_ONLINE_IMAGE.
Sesi [keluar]
DismSession yang valid. DismSession harus dikaitkan dengan gambar. Anda dapat mengaitkan sesi dengan gambar dengan menggunakan DismOpenSession.
Mengembalikan nilai
Mengembalikan S_OK pada keberhasilan.
Mengembalikan HRESULT_FROM_WIN32(ERROR_ALREADY_EXISTS) jika DismSession sudah memiliki gambar yang terkait dengannya.
Mengembalikan kode kesalahan Win32 yang dipetakan ke HRESULT untuk kesalahan lainnya.
Keterangan
DismSession dapat digunakan untuk melayani gambar setelah panggilan DismOpenSession berhasil diselesaikan. DismSession harus dimatikan dengan memanggil DismCloseSession.
Contoh
HRESULT hr = S_OK;
DismSession Session = DISM_SESSION_DEFAULT;
hr = DismOpenSession(L"C:\\Mount\\", NULL, NULL, &Session);
Persyaratan
| Persyaratan | Deskripsi |
|---|---|
| Platform host yang didukung | 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 |
| 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 |