From 54421bf806491999e3f3225b1b19f914ab9257c6 Mon Sep 17 00:00:00 2001
From: Jeff Latimer <lats@yless4u.com.au>
Date: Mon, 6 Nov 2006 22:49:51 +1100
Subject: [PATCH] ntdll: Clarify the documentation for HandleTable.

---
 dlls/ntdll/handletable.c | 10 ++++++++++
 1 file changed, 10 insertions(+)

diff --git a/dlls/ntdll/handletable.c b/dlls/ntdll/handletable.c
index 51eb6cee3eb..51057161273 100644
--- a/dlls/ntdll/handletable.c
+++ b/dlls/ntdll/handletable.c
@@ -186,6 +186,16 @@ static NTSTATUS RtlpAllocateSomeHandles(RTL_HANDLE_TABLE * HandleTable)
  *  Success: Pointer to allocated handle.
  *  Failure: NULL.
  *
+ * NOTES
+ *  A valid handle must have the bit set as indicated in the code below 
+ *  otherwise subsquent RtlIsValidHandle() calls will fail.
+ *
+ *  static inline void RtlpMakeHandleAllocated(RTL_HANDLE * Handle)
+ *  {
+ *    ULONG_PTR *AllocatedBit = (ULONG_PTR *)(&Handle->Next);
+ *    *AllocatedBit = *AllocatedBit | 1;
+ *  }
+ *
  * SEE
  *  RtlFreeHandle().
  */