Metodo IDebugClient5::GetIdentity (dbgeng.h)

Articolo
02/06/2025

Il metodo GetIdentity restituisce una stringa che descrive il computer e l'utente rappresentato dal client.

Sintassi

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

Parametri

[out, optional] Buffer

Specifica il buffer per ricevere la stringa. Se buffer è null, queste informazioni non vengono restituite.

[in] BufferSize

Specifica le dimensioni del buffer Buffer.

[out, optional] IdentitySize

Riceve le dimensioni della stringa. Se IdentitySize è null, queste informazioni non vengono restituite.

Valore restituito

Questo metodo può anche restituire valori di errore. Per altri dettagli, vedere valori restituiti.

Codice restituito	Descrizione
S_OK	Il metodo ha avuto esito positivo
S_FALSE	La dimensione della stringa è maggiore della dimensione del buffer, quindi è stata troncata per adattarsi al buffer.

Osservazioni

Il contenuto specifico della stringa varia in base al sistema operativo. Se il client è connesso in remoto, potrebbero essere presenti anche alcune informazioni di rete.

Per altre informazioni sugli oggetti client, vedere oggetti client.