IDebugClient3::GetIdentity-Methode (dbgeng.h)

Artikel
02/23/2024

Die GetIdentity-Methode gibt eine Zeichenfolge zurück, die den Computer und den Benutzer beschreibt, 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 empfangen soll. Wenn PufferNULL ist, werden diese Informationen nicht zurückgegeben.

[in] BufferSize

Gibt die Größe des Pufferpuffers an.

[out, optional] IdentitySize

Empfängt die Größe der Zeichenfolge. Wenn IdentitySizeNULL 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, sodass sie abgeschnitten wurde, um in den Puffer zu passen.

Hinweise

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.