Função CoGetCallerTID (combaseapi.h)

Retorna um ponteiro para um DWORD que contém a ID de apartamento do thread do chamador.

Sintaxe

HRESULT CoGetCallerTID(
  [out] LPDWORD lpdwTID
);

Parâmetros

[out] lpdwTID

Recebe a ID do apartamento do thread do chamador. Para um STA (single threaded apartment), essa é a ID do thread atual. Para um MTA (multithreaded apartment), o valor é 0. Para um NA (apartamento neutro), o valor é -1.

Valor retornado

Essa função pode retornar os valores a seguir.

Código de retorno	Descrição
S_TRUE	A ID de thread do chamador está definida e o chamador está no mesmo processo.
S_FALSE	A ID de thread do chamador está definida e o chamador está em um processo diferente.
E_OUTOFMEMORY	A ID do thread do chamador não foi definida.

Comentários

Se o chamador não estiver em execução no mesmo computador, essa função não retornará a ID do apartamento e o valor retornado será S_FALSE.

Não há nenhuma garantia de que as informações retornadas dessa API não sejam adulteradas, portanto, não use a ID retornada para tomar decisões de segurança. A ID só pode ser usada para fins de log e diagnóstico.

Requisitos

Cliente mínimo com suporte	Windows 2000 Professional [somente aplicativos da área de trabalho]
Servidor mínimo com suporte	Windows 2000 Server [somente aplicativos da área de trabalho]
Plataforma de Destino	Windows
Cabeçalho	combaseapi.h (inclua Objbase.h)
Biblioteca	Ole32.lib
DLL	Ole32.dll