CoGetCallerTID 函式 (combaseapi.h)

傳回 DWORD 的指標，其中包含呼叫端執行緒的 Apartment 識別碼。

語法

HRESULT CoGetCallerTID(
  [out] LPDWORD lpdwTID
);

[out] lpdwTID

接收呼叫端執行緒的 Apartment 識別碼。對於單一線程 Apartment (STA) ，這是目前的執行緒識別碼。對於多執行緒 Apartment (MTA) ，此值為 0。對於中性 Apartment (NA) ，此值為 -1。

此函式可以傳回下列值。

傳回碼	Description
S_TRUE	呼叫端的執行緒識別碼已設定，且呼叫端位於相同的進程中。
S_FALSE	呼叫端的執行緒識別碼已設定，且呼叫端位於不同的進程中。
E_OUTOFMEMORY	未設定呼叫端的執行緒識別碼。

如果呼叫端未在同一部電腦上執行，此函式不會傳回 Apartment 識別碼，而且傳回值S_FALSE。

不保證從此 API 傳回的資訊不會遭到竄改，因此請勿使用傳回的識別碼來進行安全性決策。識別碼只能用於記錄和診斷用途。