Compartilhar via

Função CoGetCallerTID (combaseapi.h)

  • Artigo

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