Returns a handle to an existing process object.

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

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 OpenProcess 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 CloseHandle.

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 GetLastError.

Requirements

Notes

• In the iwin32 API, OpenProcess and RtOpenProcess are synonyms.
• This function operates in the real-time portion of your application.
• The iwin32x API also includes an RtOpenProcess function that operates in the Windows portion of your application.

See Also

CloseHandle, RtCreateProcess, GetCurrentProcessId, iwin32 API, iwin32 Overview