通过

CoGetCallerTID 函数 (combaseapi.h)

  • 项目

返回指向包含调用方线程单元 ID 的 DWORD 的指针。

语法

HRESULT CoGetCallerTID(
  [out] LPDWORD lpdwTID
);

参数

[out] lpdwTID

接收调用方线程的单元 ID。 对于单线程单元 (STA) ，这是当前线程 ID。 对于多线程单元 (MTA) ，值为 0。 对于 na) (中性公寓，值为 -1。

返回值

此函数可以返回以下值。

返回代码 说明
S_TRUE
 设置调用方线程 ID，调用方位于同一进程中。
S_FALSE
 已设置调用方线程 ID，并且调用方位于其他进程中。
E_OUTOFMEMORY
 未设置调用方线程 ID。

注解

如果调用方未在同一台计算机上运行，则此函数不会返回单元 ID，并且返回值S_FALSE。

无法保证从此 API 返回的信息不会被篡改，因此请勿使用返回的 ID 做出安全决策。 该 ID 只能用于日志记录和诊断目的。

要求

   
最低受支持的客户端 Windows 2000 Professional [仅限桌面应用]
最低受支持的服务器 Windows 2000 Server [仅限桌面应用]
目标平台 Windows
标头 combaseapi.h (包括 Objbase.h)
Library Ole32.lib
DLL Ole32.dll