xHarbour Reference Documentation > Function Reference

GetSystemThreadID()

Retrieves the numeric system Thread ID of a thread.

Syntax

GetSystemThreadID( [<pThreadHandle>] ) --> nSystemTID

Arguments

<pThreadHandle>

This the a handle of the thread to retrieve the system ID for. If omitted, the system thread ID of the current thread is retrieved.

Return

The function returns the numeric ID of a thread as it is used by the operating system.

Description

When a new thread is started, it gets assigned a unique numeric Thread ID (TID) by the operating system. The system TID of the current or a particular thread is returned by GetSystemThreadID(). It is mainly of informational use, since system TIDs are random generated. xHarbour's virtual machine maintains an additional TID which is sequentially generated. See function GetThreadID() for more information.

Info

See also:	GetCurrentThread(), GetThreadID(), HB_MutexCreate(), StartThread(), ThreadSleep()
Category:	Multi-threading functions , xHarbour extensions
Source:	vm\thread.c
LIB:	xhbmt.lib
DLL:	xhbmtdll.dll