Método IDebugClient5::GetIdentity (dbgeng.h)

O método GetIdentity retorna uma cadeia de caracteres que descreve o computador e o usuário que esse cliente representa.

Sintaxe

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

Parâmetros

[out, optional] Buffer

Especifica o buffer para receber a cadeia de caracteres. Se Buffer for NULL, essas informações não serão retornadas.

[in] BufferSize

Especifica o tamanho do Buffer de buffer.

[out, optional] IdentitySize

Recebe o tamanho da cadeia de caracteres. Se IdentitySize for NULL, essas informações não serão retornadas.

Valor retornado

Esse método também pode retornar valores de erro. Consulte Valores retornados para obter mais detalhes.

Código de retorno Descrição
S_OK
O método foi bem-sucedido
S_FALSE
O tamanho da cadeia de caracteres era maior que o tamanho do buffer, portanto, ele foi truncado para caber no buffer.

Comentários

O conteúdo específico da cadeia de caracteres varia de acordo com o sistema operacional. Se o cliente estiver conectado remotamente, algumas informações de rede também poderão estar presentes.

Para obter mais informações sobre objetos cliente, consulte Objetos do Cliente.

Requisitos

   
Plataforma de Destino Área de trabalho
Cabeçalho dbgeng.h (include Dbgeng.h)

Confira também

Idebugclient

IDebugClient2

IDebugClient3

IDebugClient4

IDebugClient5

OutputIdentity