Added NSTDWindowsHeapHandle.

Author: RustEnthusiast

CHANGELOG.md

@@ -3,13 +3,13 @@
 - The overflow behavior for the "release" profile has been set to panic.
 - The panic behavior for the "release" profile has been set to abort.
 ### `nstd.core`
-- `str[_mut]_to_*` functions now return `Optional`.
+- `str[_mut]_to_*` functions now return `NSTDOptional`.
 - Added `cstr[_mut]_[first|last][_const]`.
 - Added `ops`.
 - Added `cty_is_unicode`.
 - Renamed `str[_mut]_get_char` to `str[_mut]_get`.
-- Added `Optional`.
-- Added `Result`.
+- Added `NSTDOptional`.
+- Added `NSTDResult`.
 - Added `panic`.
 - Made `math_[clamp|div_ceil|div_floor]_*` safe.
 ### `nstd.cstring`
@@ -18,6 +18,7 @@
 ### `nstd.fs`
 - Added `NSTDFileResult`.
 ### `nstd.os`
+- Added `NSTDWindowsHeapHandle`.
 - Added `NSTDWindowsSharedLibHandle`.
 - Added `unix.alloc`.
 - Added `[unix|windows].shared_lib`.

include/nstd/os/windows/alloc/heap.h

@@ -4,10 +4,13 @@
 #include "../../../nstd.h"
 #include "alloc.h"
 
+/// A raw handle to a heap.
+typedef NSTDInt NSTDWindowsHeapHandle;
+
 /// A handle to a process heap.
 typedef struct {
     /// The private handle.
-    NSTDInt handle;
+    NSTDWindowsHeapHandle handle;
 } NSTDWindowsHeap;
 
 /// A result type that holds an `NSTDWindowsHeap` as the success variant.
@@ -40,6 +43,17 @@ NSTDAPI NSTDWindowsHeapResult nstd_os_windows_alloc_heap_default();
 /// See <https://docs.microsoft.com/en-us/windows/win32/api/heapapi/nf-heapapi-heapcreate>.
 NSTDAPI NSTDWindowsHeapResult nstd_os_windows_alloc_heap_new(NSTDUInt size);
 
+/// Returns a raw handle to a heap.
+///
+/// # Parameters:
+///
+/// - `const NSTDWindowsHeap *heap` - The heap.
+///
+/// # Returns
+///
+/// `NSTDWindowsHeapHandle handle` - A native handle to the heap.
+NSTDAPI NSTDWindowsHeapHandle nstd_os_windows_alloc_heap_handle(const NSTDWindowsHeap *heap);
+
 /// Returns the size of a memory block previously allocated by an `NSTDWindowsHeap`.
 ///
 /// # Parameters:

src/os/windows/alloc/heap.rs

@@ -8,11 +8,14 @@ use windows_sys::Win32::System::Memory::{
     HeapValidate, HEAP_ZERO_MEMORY,
 };
 
+/// A raw handle to a heap.
+pub type NSTDWindowsHeapHandle = NSTDInt;
+
 /// A handle to a process heap.
 #[repr(C)]
 pub struct NSTDWindowsHeap {
     /// The private handle.
-    handle: NSTDInt,
+    handle: NSTDWindowsHeapHandle,
 }
 impl Drop for NSTDWindowsHeap {
     /// [NSTDWindowsHeap] destructor.
@@ -121,6 +124,39 @@ pub unsafe extern "C" fn nstd_os_windows_alloc_heap_new(size: NSTDUInt) -> NSTDW
     }
 }
 
+/// Returns a raw handle to a heap.
+///
+/// # Parameters:
+///
+/// - `const NSTDWindowsHeap *heap` - The heap.
+///
+/// # Returns
+///
+/// `NSTDWindowsHeapHandle handle` - A native handle to the heap.
+///
+/// # Example
+///
+/// ```
+/// use nstd_sys::{
+///     core::result::NSTDResult,
+///     os::windows::alloc::heap::{
+///         nstd_os_windows_alloc_heap_default, nstd_os_windows_alloc_heap_handle,
+///     },
+/// };
+///
+/// if let NSTDResult::Ok(heap) = unsafe { nstd_os_windows_alloc_heap_default() } {
+///     let handle = nstd_os_windows_alloc_heap_handle(&heap);
+///     assert!(handle != 0);
+/// }
+/// ```
+#[inline]
+#[cfg_attr(feature = "clib", no_mangle)]
+pub extern "C" fn nstd_os_windows_alloc_heap_handle(
+    heap: &NSTDWindowsHeap,
+) -> NSTDWindowsHeapHandle {
+    heap.handle
+}
+
 /// Returns the size of a memory block previously allocated by an `NSTDWindowsHeap`.
 ///
 /// # Parameters: