Метод IDebugClient3::GetIdentity (dbgeng.h)

Метод GetIdentity возвращает строку, описывающую компьютер и пользователя, который представляет этот клиент.

Синтаксис

HRESULT GetIdentity(
  [out, optional] PSTR   Buffer,
  [in]            ULONG  BufferSize,
  [out, optional] PULONG IdentitySize
);

Параметры

[out, optional] Buffer

Указывает буфер для получения строки. Если параметр Buffer имеет значение NULL, эти сведения не возвращаются.

[in] BufferSize

Задает размер буфера буфера.

[out, optional] IdentitySize

Получает размер строки. Если параметр IdentitySize имеет значение NULL, эти сведения не возвращаются.

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

Этот метод также может возвращать значения ошибок. Дополнительные сведения см. в разделе Возвращаемые значения .

Код возврата Описание
S_OK
Метод выполнен успешно
S_FALSE
Размер строки был больше размера буфера, поэтому она была усечена, чтобы поместиться в буфер.

Комментарии

Конкретное содержимое строки зависит от операционной системы. Если клиент подключен удаленно, также могут присутствовать некоторые сведения о сети.

Дополнительные сведения о клиентских объектах см. в разделе Клиентские объекты.

Требования

Требование Значение
Целевая платформа Персональный компьютер
Верхняя часть dbgeng.h (включая Dbgeng.h)

См. также раздел

IDebugClient

IDebugClient2

IDebugClient3

IDebugClient4

IDebugClient5

OutputIdentity