Fungsi DismInitialize
[Beberapa informasi berkaitan dengan produk pra-rilis yang mungkin dimodifikasi secara substansial sebelum dirilis secara komersial. Microsoft tidak memberikan jaminan, tersurat maupun tersirat, sehubungan dengan informasi yang diberikan di sini.]
Menginisialisasi API DISM. DismInitialize harus dipanggil sekali per proses, sebelum memanggil fungsi API DISM lainnya.
Sintaks
HRESULT WINAPI DismInitialize(
_In_ DismLogLevel LogLevel,
_In_opt_ PCWSTR LogFilePath,
_In_opt_ PCWSTR ScratchDirectory
);
Parameter
LogLevel [in]
Nilai enumerasi DismLogLevel , seperti DismLogErrorsWarnings.
LogFilePath [in, opsional]
Pilihan. Jalur relatif atau absolut ke file log. Semua pesan yang dihasilkan akan dicatat ke jalur ini. Jika NULL, jalur log default, %windir%\Logs\DISM\dism.log, akan digunakan.
ScratchDirectory [in, opsional]
Opsional. Jalur relatif atau absolut ke direktori scratch. DISM API akan menggunakan direktori ini untuk operasi internal. Jika NULL, direktori temp default, \Windows\%Temp%, akan digunakan.
Mengembalikan nilai
Mengembalikan S_OK pada keberhasilan.
Mengembalikan DISMAPI_E_DISMAPI_ALREADY_INITIALIZED jika DismInitialize telah dipanggil oleh proses tanpa panggilan yang cocok ke DismShutdown.
Mengembalikan HRESULT_FROM_WIN32(ERROR_ELEVATION_REQUIRED) jika proses tidak ditingkatkan.
Keterangan
Kode klien harus memanggil DismInitialize sekali per proses. DISM API akan menserialisasikan panggilan bersamaan ke DismInitialize. Panggilan pertama akan berhasil dan yang lain akan gagal. Untuk informasi selengkapnya, lihat Menggunakan API DISM.
Contoh
HRESULT hr = S_OK;
DismLogLevel Level = DismLogErrorsWarningsInfo;
hr = DismInitialize(Level, NULL, NULL);
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 |