CoGetCallerTID 函数 (combaseapi.h)
返回指向包含调用方线程单元 ID 的 DWORD 的指针。
语法
HRESULT CoGetCallerTID(
[out] LPDWORD lpdwTID
);
参数
[out] lpdwTID
接收调用方线程的单元 ID。 对于单线程单元 (STA) ，这是当前线程 ID。 对于多线程单元 (MTA) ，值为 0。 对于 na) (中性公寓，值为 -1。
返回值
此函数可以返回以下值。
| 返回代码 | 说明 |
|---|---|
|
设置调用方线程 ID，调用方位于同一进程中。 |
|
已设置调用方线程 ID，并且调用方位于其他进程中。 |
|
未设置调用方线程 ID。 |
注解
如果调用方未在同一台计算机上运行，则此函数不会返回单元 ID，并且返回值S_FALSE。
无法保证从此 API 返回的信息不会被篡改，因此请勿使用返回的 ID 做出安全决策。 该 ID 只能用于日志记录和诊断目的。
要求
| 最低受支持的客户端 | Windows 2000 Professional [仅限桌面应用] |
| 最低受支持的服务器 | Windows 2000 Server [仅限桌面应用] |
| 目标平台 | Windows |
| 标头 | combaseapi.h (包括 Objbase.h) |
| Library | Ole32.lib |
| DLL | Ole32.dll |