Function query_description

resources/windows_service/src/service.rs:315–350

Query the service description string.

(service_handle: SC_HANDLE)

/// Query the service description string.
unsafe fn query_description(service_handle: SC_HANDLE) -> Option<String> {
    let mut bytes_needed: u32 = 0;
    let _ = unsafe {
        QueryServiceConfig2W(
            service_handle,
            SERVICE_CONFIG_DESCRIPTION,
            None,
            &mut bytes_needed,
        )
    };

    if bytes_needed == 0 {
        return None;
    }

    let mut buffer = vec![0u8; bytes_needed as usize];
    if unsafe {
        QueryServiceConfig2W(
            service_handle,
            SERVICE_CONFIG_DESCRIPTION,
            Some(&mut buffer),
            &mut bytes_needed,
        )
    }
    .is_ok()
    {
        let desc = unsafe { &*(buffer.as_ptr().cast::<SERVICE_DESCRIPTIONW>()) };
        if desc.lpDescription.is_null() {
            None
        } else {
            unsafe { desc.lpDescription.to_string().ok() }
        }
    } else {
        None
    }
}

/// Query the current runtime status of a service.
unsafe fn query_status(service_handle: SC_HANDLE) -> Result<ServiceStatus, ServiceError> {