Added NSTDWindowsSharedLibHandle.

Author: RustEnthusiast

CHANGELOG.md

@@ -18,6 +18,7 @@
 ### `nstd.fs`
 - Added `NSTDFileResult`.
 ### `nstd.os`
+- Added `NSTDWindowsSharedLibHandle`.
 - Added `unix.alloc`.
 - Added `[unix|windows].shared_lib`.
 - Added `NSTDWindowsHeapResult`.

include/nstd/os/windows/shared_lib.h

@@ -3,10 +3,13 @@
 #include "../../core/optional.h"
 #include "../../nstd.h"
 
+/// A raw handle to a dynamically loaded library.
+typedef NSTDInt NSTDWindowsSharedLibHandle;
+
 /// A handle to a loaded library.
 typedef struct {
     /// A raw handle to the module.
-    NSTDInt handle;
+    NSTDWindowsSharedLibHandle handle;
 } NSTDWindowsSharedLib;
 
 /// An optional (possibly null) shared Windows library handle.
@@ -28,6 +31,18 @@ NSTDOptional(NSTDWindowsSharedLib) NSTDWindowsOptionalSharedLib;
 /// <https://docs.microsoft.com/en-us/windows/win32/api/libloaderapi/nf-libloaderapi-loadlibrarya>.
 NSTDAPI NSTDWindowsOptionalSharedLib nstd_os_windows_shared_lib_load(const NSTDChar *name);
 
+/// Returns a raw handle to a dynamically loaded library.
+///
+/// # Parameters:
+///
+/// - `const NSTDWindowsSharedLib *lib` - The loaded library.
+///
+/// # Returns
+///
+/// `NSTDWindowsSharedLibHandle handle` - A native handle to the dynamically loaded library.
+NSTDAPI NSTDWindowsSharedLibHandle nstd_os_windows_shared_lib_handle(
+const NSTDWindowsSharedLib *lib);
+
 /// Gets a pointer to a function or static variable in a dynamically loaded library by symbol name.
 ///
 /// # Parameters

src/os/windows/shared_lib.rs

@@ -2,11 +2,14 @@
 use crate::{core::optional::NSTDOptional, NSTDAny, NSTDAnyMut, NSTDChar, NSTDInt};
 use windows_sys::Win32::System::LibraryLoader::{FreeLibrary, GetProcAddress, LoadLibraryA};
 
+/// A raw handle to a dynamically loaded library.
+pub type NSTDWindowsSharedLibHandle = NSTDInt;
+
 /// A handle to a loaded library.
 #[repr(C)]
 pub struct NSTDWindowsSharedLib {
     /// A raw handle to the module.
-    handle: NSTDInt,
+    handle: NSTDWindowsSharedLibHandle,
 }
 impl Drop for NSTDWindowsSharedLib {
     /// [NSTDWindowsSharedLib]'s destructor.
@@ -45,6 +48,23 @@ pub unsafe extern "C" fn nstd_os_windows_shared_lib_load(
     }
 }
 
+/// Returns a raw handle to a dynamically loaded library.
+///
+/// # Parameters:
+///
+/// - `const NSTDWindowsSharedLib *lib` - The loaded library.
+///
+/// # Returns
+///
+/// `NSTDWindowsSharedLibHandle handle` - A native handle to the dynamically loaded library.
+#[inline]
+#[cfg_attr(feature = "clib", no_mangle)]
+pub extern "C" fn nstd_os_windows_shared_lib_handle(
+    lib: &NSTDWindowsSharedLib,
+) -> NSTDWindowsSharedLibHandle {
+    lib.handle
+}
+
 /// Gets a pointer to a function or static variable in a dynamically loaded library by symbol name.
 ///
 /// # Parameters