CoGetCurrentLogicalThreadId function (combaseapi.h)

Returns the logical thread identifier of the current physical thread.

Syntax

HRESULT CoGetCurrentLogicalThreadId(
  [out] GUID *pguid
);

Parameters

[out] pguid

A pointer to a GUID that contains the logical thread ID on return.

Return value

This function can return the following values.

Return code Description
S_OK
The logical thread ID was retrieved successfully.
E_INVALIDARG
An invalid pointer was passed in for the pguid parameter.
E_OUTOFMEMORY
A memory allocation failed during the operation of the function.

Remarks

This function retrieves the identifier of the current logical thread under which this physical thread is operating. The current physical thread takes on the logical thread identifier of any client thread that makes a COM call into this application. Similarly, the logical thread identifier of the current physical thread is used to denote the causality for outgoing COM calls from this physical thread.

Requirements

Requirement Value
Minimum supported client Windows 2000 Professional [desktop apps | UWP apps]
Minimum supported server Windows 2000 Server [desktop apps | UWP apps]
Target Platform Windows
Header combaseapi.h (include Objbase.h)
Library Ole32.lib
DLL Ole32.dll