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

Artículo
02/23/2024

El método GetIdentity devuelve una cadena que describe el equipo y el usuario que representa este cliente.

Sintaxis

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

Parámetros

[out, optional] Buffer

Especifica el búfer que se va a recibir la cadena. Si Buffer es NULL, no se devuelve esta información.

[in] BufferSize

Especifica el tamaño del búfer de búfer.

[out, optional] IdentitySize

Recibe el tamaño de la cadena. Si IdentitySize es NULL, no se devuelve esta información.

Valor devuelto

Este método también puede devolver valores de error. Consulte Valores devueltos para obtener más detalles.

Código devuelto	Descripción
S_OK	El método se realizó correctamente
S_FALSE	El tamaño de la cadena era mayor que el tamaño del búfer, por lo que se truncaba para ajustarse al búfer.

Comentarios

El contenido específico de la cadena varía con el sistema operativo. Si el cliente está conectado de forma remota, también puede haber información de red.

Para obtener más información sobre los objetos de cliente, vea Objetos de cliente.