Add initial skeleton for HealthClient API in mssf_core

crates/libs/core/src/client/health_client.rs

@@ -0,0 +1,38 @@
+// ------------------------------------------------------------
+// Copyright (c) Microsoft Corporation.  All rights reserved.
+// Licensed under the MIT License (MIT). See License.txt in the repo root for license information.
+// ------------------------------------------------------------
+
+use mssf_com::FabricClient::IFabricHealthClient4;
+
+use crate::types::{FabricHealthReportWrapper, HealthReport};
+
+/// Provides functionality to perform health related operations, like report and query health.
+/// See C# API [here](https://docs.microsoft.com/en-us/dotnet/api/system.fabric.fabricclient.healthclient?view=azure-dotnet).
+///
+/// TODO: Implement full functionality of the HealthClient.
+#[derive(Debug, Clone)]
+pub struct HealthClient {
+    com: IFabricHealthClient4,
+}
+
+// Public implementation block
+impl HealthClient {
+    pub fn from_com(com: IFabricHealthClient4) -> Self {
+        Self { com: com.clone() }
+    }
+
+    /// Reports health on a Service Fabric entity. See C# API [here](https://docs.microsoft.com/en-us/dotnet/api/system.fabric.fabricclient.healthclient.reporthealth?view=azure-dotnet).
+    ///
+    /// Remarks:
+    /// When a cluster is secured, the health client needs administrator permission to be able to send the reports.
+    /// Read more about [connecting to a cluster using the FabricClient APIs](https://learn.microsoft.com/en-us/azure/service-fabric/service-fabric-connect-to-secure-cluster).
+    /// For more information about health reporting, see [Service Fabric health monitoring](https://learn.microsoft.com/en-us/azure/service-fabric/service-fabric-health-introduction).
+    pub fn report_health(&self, health_report: &HealthReport) -> windows_core::Result<()> {
+        // The following call will construct a FabricHealthReportWrapper from the HealthReport.
+        // It does a few heap memory allocations, but it is necessary to pass the health_report to the COM API.
+        // The memory allocations are then freed by the FabricHealthReportWrapper when it goes out of scope.
+        let health_report_wrapper = FabricHealthReportWrapper::from(health_report);
+        unsafe { self.com.ReportHealth(&health_report_wrapper.inner.unwrap()) }
+    }
+}

crates/libs/core/src/client/mod.rs

@@ -4,9 +4,10 @@
 // ------------------------------------------------------------
 
 use connection::{ClientConnectionEventHandlerBridge, LambdaClientConnectionNotificationHandler};
+use health_client::HealthClient;
 use mssf_com::FabricClient::{
-    IFabricClientConnectionEventHandler, IFabricPropertyManagementClient2, IFabricQueryClient10,
-    IFabricServiceManagementClient6, IFabricServiceNotificationEventHandler,
+    IFabricClientConnectionEventHandler, IFabricHealthClient4, IFabricPropertyManagementClient2,
+    IFabricQueryClient10, IFabricServiceManagementClient6, IFabricServiceNotificationEventHandler,
 };
 use notification::{
     LambdaServiceNotificationHandler, ServiceNotificationEventHandler,
@@ -20,6 +21,9 @@ use self::{query_client::QueryClient, svc_mgmt_client::ServiceManagementClient};
 
 mod connection;
 mod notification;
+
+// Export public client modules
+pub mod health_client;
 pub mod query_client;
 pub mod svc_mgmt_client;
 
@@ -201,6 +205,7 @@ pub struct FabricClient {
     com_property_client: IFabricPropertyManagementClient2,
     com_service_client: IFabricServiceManagementClient6,
     com_query_client: IFabricQueryClient10,
+    com_health_client: IFabricHealthClient4,
 }
 
 impl FabricClient {
@@ -209,44 +214,51 @@ impl FabricClient {
         FabricClientBuilder::new()
     }
 
-    // Get a copy of COM object
+    /// Get a copy of COM object
     pub fn get_com(&self) -> IFabricPropertyManagementClient2 {
         self.com_property_client.clone()
     }
 
-    // Creates from com directly. This gives the user freedom to create com from
-    // custom code and pass it in.
-    // For the final state of FabricClient, this function should be private.
+    /// Creates from com directly. This gives the user freedom to create com from
+    /// custom code and pass it in.
+    /// For the final state of FabricClient, this function should be private.
     pub fn from_com(com: IFabricPropertyManagementClient2) -> Self {
         let com_property_client = com.clone();
         let com_service_client = com
             .clone()
             .cast::<IFabricServiceManagementClient6>()
             .unwrap();
         let com_query_client = com.clone().cast::<IFabricQueryClient10>().unwrap();
+        let com_health_client = com.clone().cast::<IFabricHealthClient4>().unwrap();
         Self {
             com_property_client,
             com_service_client,
             com_query_client,
+            com_health_client,
         }
     }
 
-    // Get the client for managing Fabric Properties in Naming Service
+    /// Get the client for managing Fabric Properties in Naming Service
     pub fn get_property_manager(&self) -> PropertyManagementClient {
         PropertyManagementClient {
             _com: self.com_property_client.clone(),
         }
     }
 
-    // Get the client for quering SF info.
+    /// Get the client for quering Service Fabric information.
     pub fn get_query_manager(&self) -> QueryClient {
         QueryClient::from_com(self.com_query_client.clone())
     }
 
-    // Get the client for managing service info and lifecycles.
+    /// Get the client for managing service information and lifecycles.
     pub fn get_service_manager(&self) -> ServiceManagementClient {
         ServiceManagementClient::from_com(self.com_service_client.clone())
     }
+
+    /// Get the client for get/set Service Fabric health properties.
+    pub fn get_health_manager(&self) -> HealthClient {
+        HealthClient::from_com(self.com_health_client.clone())
+    }
 }
 
 pub struct PropertyManagementClient {