Funzione CoGetCallerTID (combaseapi.h)

Restituisce un puntatore a un DWORD contenente l'ID appartamento del thread del chiamante.

Sintassi

HRESULT CoGetCallerTID(
  [out] LPDWORD lpdwTID
);

Parametri

[out] lpdwTID

Riceve l'ID dell'appartamento del thread del chiamante. Per un singolo appartamento threaded (STA), si tratta dell'ID thread corrente. Per un appartamento multithreaded (MTA), il valore è 0. Per un appartamento neutrale (NA), il valore è -1.

Valore restituito

Questa funzione può restituire i valori seguenti.

Codice restituito	Descrizione
S_TRUE	L'ID thread del chiamante è impostato e il chiamante si trova nello stesso processo.
S_FALSE	L'ID thread del chiamante è impostato e il chiamante si trova in un processo diverso.
E_OUTOFMEMORY	L'ID thread del chiamante non è stato impostato.

Commenti

Se il chiamante non è in esecuzione nello stesso computer, questa funzione non restituisce l'ID appartamento e il valore restituito è S_FALSE.

Non vi è alcuna garanzia che le informazioni restituite da questa API non vengano manomesse, quindi non usare l'ID restituito per prendere decisioni di sicurezza. L'ID può essere usato solo per scopi di registrazione e diagnostica.

Requisiti

Client minimo supportato	Windows 2000 Professional [solo app desktop]
Server minimo supportato	Windows 2000 Server [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	combaseapi.h (include Objbase.h)
Libreria	Ole32.lib
DLL	Ole32.dll