IDebugClient5::GetKernelConnectionOptions-Methode (dbgeng.h)

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.

Anforderungen

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

Weitere Informationen

AttachKernel

IDebugClient

IDebugClient2

IDebugClient3

IDebugClient4

IDebugClient5