IDebugInputCallbacks::StartInput-Methode (dbgeng.h)

Die StartInput-Rückrufmethode wird von der Engine aufgerufen, um anzugeben, dass sie auf eine Eingabezeile wartet.

Syntax

HRESULT StartInput(
  [in] ULONG BufferSize
);

Parameter

[in] BufferSize

Gibt die Anzahl der angeforderten Zeichen an. Alle Eingaben, die länger als diese Größe sind, werden abgeschnitten.

Rückgabewert

Der Rückgabewert wird vom Modul ignoriert, es sei denn, er weist auf einen Remoteprozeduraufruffehler hin. in diesem Fall ist der Client, bei dem dieses IDebugEventCallbacks-Objekt registriert ist, deaktiviert.

Hinweise

Diese Methode gibt an, dass die Engine auf eine Eingabezeile von einem beliebigen Client wartet. Dies kann beispielsweise auftreten, wenn die Input-Methode auf einem Client aufgerufen wurde.

Nach dem Aufrufen dieser Methode wartet das Modul, bis es eine Eingabe empfängt. Wenn es eine Eingabe empfängt, wird IDebugInputCallbacks::EndInput aufgerufen, um alle IDebugInputCallbacks-Objekte , die bei Clients registriert sind, darüber zu informieren, dass sie nicht mehr auf eingabe warten.

Das IDebugInputCallbacks-Objekt kann dem Modul eine Eingabezeile bereitstellen, indem entweder die ReturnInput - oder ReturnInputWide-Methode aufgerufen wird.

Weitere Informationen zur Eingabe des Debuggermoduls finden Sie unter Eingabe und Ausgabe.

Anforderungen

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