cmdpal 0.1.0

Rust SDK for PowerToys Command Palette
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33

use windows::core::{implement, ComObject};
use windows::Win32::Foundation::E_POINTER;
use windows::Win32::System::Com::{IClassFactory, IClassFactory_Impl};
use windows_core::Interface;
use crate::bindings::IExtension;
use crate::ext::Extension;

#[implement(IClassFactory)]
pub struct ExtensionClassFactory(pub ComObject<Extension>);

impl IClassFactory_Impl for ExtensionClassFactory_Impl {
    /// SAFETY: This function does not validate the validity of `iid` and `interface`.
    /// Therefore, it is inherently unsound. The caller must ensure that `iid` and `interface`
    /// are valid pointers. On the Rust side, `CoCreateInstance` is already an unsafe function,
    /// and we rely on the caller to carefully validate their pointers. For FFI calls, we must
    /// similarly trust that the caller has ensured pointer validity.
    #[allow(clippy::not_unsafe_ptr_arg_deref)]
    fn CreateInstance(&self, _: windows_core::Ref<'_, windows_core::IUnknown>, iid: *const windows_core::GUID, interface: *mut *mut core::ffi::c_void) -> windows_core::Result<()> {
        // Validate the interface pointer for minimal safety.
        if iid.is_null() || interface.is_null() {
            return Err(E_POINTER.into());
        }
        let extension = self.0.cast::<IExtension>()?;
        unsafe {
            // SAFETY: described in documentation.
            extension.query(iid, interface).ok()
        }
    }

    fn LockServer(&self, _: windows_core::BOOL) -> windows_core::Result<()> {
        Ok(())
    }
}