[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 |
Source: Microsoft Learn / Windows Win32 documentation by Microsoft and contributors. Documentation licensed CC BY 4.0. Code samples are covered by the MIT License. Converted from Markdown, with links normalized and embedded media omitted.
