IDebugClient::GetIdentity-Methode (dbgeng.h)

Artikel
02/06/2025

Die GetIdentity--Methode gibt eine Zeichenfolge zurück, die den Computer beschreibt und der Benutzer, den dieser Client darstellt.

Syntax

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

Parameter

[out, optional] Buffer

Gibt den Puffer an, der die Zeichenfolge empfängt. Wenn Puffer-NULL-ist, werden diese Informationen nicht zurückgegeben.

[in] BufferSize

Gibt die Größe des Puffers Puffer-an.

[out, optional] IdentitySize

Empfängt die Größe der Zeichenfolge. Wenn IdentitySize-NULL-ist, werden diese Informationen nicht zurückgegeben.

Rückgabewert

Diese Methode kann auch Fehlerwerte zurückgeben. Weitere Informationen finden Sie unter Rückgabewerte.

Rückgabecode	Beschreibung
S_OK	Die Methode war erfolgreich.
S_FALSE	Die Größe der Zeichenfolge war größer als die Größe des Puffers, daher wurde sie abgeschnitten, um in den Puffer einzupassen.

Bemerkungen

Der spezifische Inhalt der Zeichenfolge variiert je nach Betriebssystem. Wenn der Client remote verbunden ist, sind möglicherweise auch einige Netzwerkinformationen vorhanden.

Weitere Informationen zu Clientobjekten finden Sie unter Clientobjekte.