IDebugClient2::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 Leerraum für das "\0"-Endzeichen.

[out, optional] OptionsSize

Empfängt die Größe der Verbindungsoptionen in Zeichen. Diese Größe enthält den Leerraum für das "\0"-Endzeichen. Wenn OptionsSizenull ist, werden diese Informationen nicht zurückgegeben.

Rückgabewert

Diese Methode gibt möglicherweise auch Fehlerwerte zurück. 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 Standardmäßiges Live-Kernelziel.

Hinweise

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

Bei den zurückgegebenen Verbindungsoptionen handelt es sich um die gleichen Optionen, die zum Herstellen einer Verbindung mit dem Kernel verwendet werden.

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