RtOpenThread

RtOpenThread opens an existing thread object and returns a handle to that thread object.

Syntax

HANDLE RtOpenThread(
    DWORD dwDesiredAccess,
    BOOL bInheritHandle,
    DWORD dwThreadId
);

Parameters

dwDesiredAccess

Ignored.

bInheritHandle

Ignored.

dwThreadId

The identifier of the thread object to be opened. This must be an existing thread ID in the current process.

Return Value

A handle to the thread object if the function succeeds, NULL if the function fails

Remarks

The handle returned by RtOpenThread can only be used within the RTSS process environment.

RtOpenThread can only be used to open a handle to a thread in the calling process. You cannot open a handle to a thread in a different process.