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 |
|
Library |
|