ObFindHandleForObject function

[This function is obsolete and may be altered or unavailable in future versions of Windows. Avoid using this function.]

Retrieves an object handle for the specified object associated with the specified process.

Syntax

BOOLEAN WINAPI ObFindHandleForObject(
  _In_     PEPROCESS Process,
  _In_     PVOID     Object,
  _In_opt_ PVOID     Reserved1,
  _In_opt_ PVOID     Reserved2,
  _Out_    PHANDLE   Handle
);

Parameters

Process [in]

The process. This handle is returned by the IoGetCurrentProcess or PsGetCurrentProcess function.

Object [in]

A pointer to the object.

Reserved1 [in, optional]

Reserved.

Reserved2 [in, optional]

Reserved.

Handle [out]

The object handle.

Return value

The function returns TRUE if a match is found and FALSE otherwise.

Remarks

This function is available in Ntoskrnl.exe and can be called only from kernel mode. The corresponding import library is available through the Windows Driver Kit (WDK).

Requirements

Requirement Value
Minimum supported client
Windows XP [desktop apps only]
Minimum supported server
Windows Server 2003 [desktop apps only]
Header
Ntosp.h
Library
Ntoskrnl.lib