Returns a handle to the process with the given ID.

HANDLE RtOpenProcess(
    DWORD dwDesiredAccess,
    BOOLEAN bInheritHandle,
    DWORD dwProcessId
);

Parameters

dwDesiredAccess

Ignored.

bInheritHandle

Ignored.

dwProcessId

Specifies the process identifier of the process to open.

Remarks

The handle returned by RtOpenProcess can be used in any function that requires a handle to a process, such as wait functions.

When you finish with the handle, close it using RtCloseHandle.

RtOpenProcess can also be used from a Windows application to obtain the handle of an iWin32 process.

Return Values

Open handle to specified process

Success.

NULL

Failure. For extended error information, see the Windows' GetLastError function.

Requirements

Notes

• This function operates in the Windows portion of your application.
• The iwin32 API also includes an RtOpenProcess function that operates in the real-time portion of your application.

See Also

RtCloseHandle, iwin32x API, iwin32 Overview