Method open

resources/dism_dsc/src/dism.rs:236–276

Opens a new DISM session for the online image. NOTE: `DismInitialize` and `DismShutdown` are per-process globals. Only one `DismSessionHandle` should exist at a time. Creating a second session while one is already open (or after one has been dropped) will call `DismInitialize` again, which returns `DISMAPI_E_DISMAPI_ALREADY_INITIALIZED`.

()

    /// dropped) will call `DismInitialize` again, which returns
    /// `DISMAPI_E_DISMAPI_ALREADY_INITIALIZED`.
    pub fn open() -> Result<Self, String> {
        let api = DismApi::load()?;

        // Load DismInitialize and DismOpenSession (only needed during open)
        let dism_initialize: DismInitializeFn =
            unsafe { load_fn(api.lib, b"DismInitialize\0")? };
        let dism_open_session: DismOpenSessionFn =
            unsafe { load_fn(api.lib, b"DismOpenSession\0")? };

        unsafe {
            let hr = dism_initialize(DISM_LOG_ERRORS, std::ptr::null(), std::ptr::null());
            if hr == REGDB_E_CLASSNOTREG {
                return Err(t!("dism.notSupportedAppx").to_string());
            }
            if hr < 0 {
                return Err(t!("dism.initializeFailed", hr = format!("0x{:08X}", hr as u32)).to_string());
            }

            let image_path = to_wide_null(DISM_ONLINE_IMAGE);
            let mut session: u32 = 0;
            let hr = dism_open_session(
                image_path.as_ptr(),
                std::ptr::null(),
                std::ptr::null(),
                &mut session,
            );
            if hr == REGDB_E_CLASSNOTREG {
                (api.shutdown)();
                return Err(t!("dism.notSupportedAppx").to_string());
            }
            if hr < 0 {
                (api.shutdown)();
                return Err(t!("dism.openSessionFailed", hr = format!("0x{:08X}", hr as u32)).to_string());
            }

            Ok(DismSessionHandle {
                handle: session,
                api,
            })
        }
    }

    pub fn get_feature_info(&self, feature_name: &str) -> Result<OptionalFeatureInfo, String> {
        let wide_name = to_wide_null(feature_name);