IDebugClient::GetKernelConnectionOptions-Methode (dbgeng.h)

Artikel
02/06/2025

Die GetKernelConnectionOptions Methode gibt die Verbindungsoptionen für das aktuelle Kernelziel zurück.

Syntax

HRESULT GetKernelConnectionOptions(
  [out, optional] PSTR   Buffer,
  [in]            ULONG  BufferSize,
  [out, optional] PULONG OptionsSize
);

Parameter

[out, optional] Buffer

Gibt den Puffer an, der die Verbindungsoptionen empfängt.

[in] BufferSize

Gibt die Größe in Zeichen des Puffers Puffer-an. Diese Größe enthält den Abstand für das Endzeichen '\0'.

[out, optional] OptionsSize

Empfängt die Größe in Zeichen der Verbindungsoptionen. Diese Größe enthält den Abstand für das Endzeichen '\0'. Wenn OptionsSize-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.
E_UNEXPECTED	Das aktuelle Ziel ist kein standardmäßiges Live-Kernelziel.

Bemerkungen

Diese Methode ist nur für Live-Kernelziele verfügbar, die nicht lokal sind und nicht über eXDI verbunden sind.

Die zurückgegebenen Verbindungsoptionen sind die gleichen Optionen, die zum Herstellen einer Verbindung mit dem Kernel verwendet werden.

Weitere Informationen zum Herstellen einer Verbindung mit Zielzielen im Live-Kernelmodus finden Sie unter Live Kernel-Mode Targets.

Anforderungen

Anforderung	Wert
Zielplattform-	Desktop
Header-	dbgeng.h (include Dbgeng.h)

Siehe auch

Freigeben über