RtlAllocateHandle3w

Usage

Overview

Allocates a handle from the handle table.

Params

HandleTable [In/Out] The handle table.

HandleIndex [Out] Index of the handle returned. Optional.

Returns

Success: Pointer to allocated handle.

Failure: NULL.

Notes

A valid handle must have the bit set as indicated in the code below otherwise subsequent RtlIsValidHandle(3w) calls will fail.

static inline void RtlpMakeHandleAllocated(RTL_HANDLE * Handle) { ULONG_PTR *AllocatedBit = (ULONG_PTR *)(&Handle->Next); *AllocatedBit = *AllocatedBit | 1; }.

See

RtlFreeHandle().

Implementation

Declared in "winternl.h".

Implemented in "dlls/ntdll/handletable.c".

Debug channel "ntdll".