Поделиться через

Функция CoGetCallerTID (combaseapi.h)

  • Статья

Возвращает указатель на DWORD , содержащий идентификатор квартиры потока вызывающего объекта.

Синтаксис

HRESULT CoGetCallerTID(
  [out] LPDWORD lpdwTID
);

Параметры

[out] lpdwTID

Получает идентификатор квартиры потока вызывающего объекта. Для однопоточного объекта (STA) это текущий идентификатор потока. Для многопоточной квартиры (MTA) значение равно 0. Для нейтральной квартиры (NA) значение равно -1.

Возвращаемое значение

Эта функция может возвращать следующие значения.

Код возврата Описание
S_TRUE
 Идентификатор потока вызывающего объекта задается, и вызывающий объект находится в том же процессе.
S_FALSE
 Идентификатор потока вызывающего объекта задается, а вызывающий объект находится в другом процессе.
E_OUTOFMEMORY
 Идентификатор потока вызывающего объекта не задан.

Комментарии

Если вызывающий объект работает не на том же компьютере, эта функция не возвращает идентификатор квартиры, а возвращаемое значение S_FALSE.

Нет никакой гарантии, что данные, возвращаемые из этого API, не будут изменены, поэтому не используйте идентификатор, который возвращается для принятия решений о безопасности. Идентификатор можно использовать только для ведения журнала и диагностики.

Требования

   
Минимальная версия клиента Windows 2000 Professional [только классические приложения]
Минимальная версия сервера Windows 2000 Server [только классические приложения]
Целевая платформа Windows
Header combaseapi.h (включая Objbase.h)
Библиотека Ole32.lib
DLL Ole32.dll