RtlAllocateHandle(3w)

NAME

RtlAllocateHandle (NTDLL.@)

SYNOPSIS

RTL_HANDLE * RtlAllocateHandle
 (
  RTL_HANDLE_TABLE* HandleTable,
  ULONG*            HandleIndex
 )

DESCRIPTION

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

Defined in "winternl.h".

Implemented in "build/buildd-wine-unstable_1.1.32-1+b1-amd64-KnxYu0/wine-unstable-1.1.32/build32/dlls/ntdll/handletable.c".

Debug channel "ntdll".
Copyright © 2010-2025 Platon Technologies, s.r.o.           Home | Man pages | tLDP | Documents | Utilities | About
Design by styleshout