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

Artigo
02/26/2024

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 Buffer.

[out, optional] IdentitySize

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

Retornar valor

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 de cliente, consulte Objetos de cliente.