IDebugClient3::GetKernelConnectionOptions-Methode (dbgeng.h)

Artikel
02/23/2024

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 empfangen soll.

[in] BufferSize

Gibt die Größe des Pufferpuffers in Zeichen an. Diese Größe enthält den Platz für das "\0"-Endzeichen.

[out, optional] OptionsSize

Empfängt die Größe der Verbindungsoptionen in Zeichen. Diese Größe enthält den Platz für das "\0"-Endzeichen. Wenn OptionsSizeNULL 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.
E_UNEXPECTED	Das aktuelle Ziel ist kein Standard-Livekernkernziel.

Hinweise

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

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

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

Anforderungen

Anforderung	Wert
Zielplattform	Desktop
Kopfzeile	dbgeng.h (einschließlich Dbgeng.h)

Weitere Informationen

Freigeben über