Freigeben über


IDebugControl2::OutputPrompt-Methode (dbgeng.h)

Die OutputPrompt-Methode formatiert und sendet eine Benutzeraufforderung an die Ausgaberückrufobjekte.

Syntax

HRESULT OutputPrompt(
  [in]           ULONG OutputControl,
  [in, optional] PCSTR Format,
                 ...   
);

Parameter

[in] OutputControl

Gibt ein Ausgabesteuerelement an, das bestimmt, welche Ausgaberückrufe des Clients die Ausgabe empfangen. Mögliche Werte finden Sie unter DEBUG_OUTCTL_XXX.

[in, optional] Format

Gibt die Formatzeichenfolge an, wie in printf. In der Regel funktionieren Konvertierungszeichen genau wie in C. Für die Gleitkommakonvertierungszeichen wird das 64-Bit-Argument als 32-Bit-Gleitkommazahl interpretiert, es sei denn, der l-Modifizierer wird verwendet.

Das % p-Konvertierungszeichen wird unterstützt, stellt aber einen Zeiger im Adressraum eines Ziels dar. Es verfügt möglicherweise über keine Modifizierer und verwendet die interne Adressformatierung des Debuggers. Die folgenden zusätzlichen Konvertierungszeichen werden unterstützt.

Zeichen Argumenttyp Argument Gedruckter Text
%p ULONG64 Zeiger in einem Adressraum. Der Wert des Zeigers.
%N DWORD_PTR (32 oder 64 Bits, abhängig von der Architektur des Hosts) Zeiger im virtuellen Adressraum des Hosts. Der Wert des Zeigers. (Dies entspricht dem standardmäßigen C %p-Zeichen .)
%I ULONG64 Ein beliebiger 64-Bit-Wert. Der angegebene Wert. Wenn dieser größer als 0xFFFFFFFF ist, wird er als 64-Bit-Wert gedruckt. Andernfalls wird er als 32-Bit-Wert ausgegeben.
%ma ULONG64 Adresse einer MIT NULL beendeten ASCII-Zeichenfolge im virtuellen Adressraum des Prozesses. Die angegebene Zeichenfolge.
%mu ULONG64 Adresse einer MIT NULL beendeten Unicode-Zeichenfolge im virtuellen Adressraum des Prozesses. Die angegebene Zeichenfolge.
%msa ULONG64 Adresse einer ANSI_STRING Struktur im virtuellen Adressraum des Prozesses. Die angegebene Zeichenfolge.
%msu ULONG64 Adresse einer UNICODE_STRING-Struktur im virtuellen Adressraum des Prozesses. Die angegebene Zeichenfolge.
%y ULONG64 Adresse im virtuellen Adressraum des Prozesses eines Elements mit Symbolinformationen. Zeichenfolge, die den Namen des angegebenen Symbols (und ggf. Verschiebung) enthält.
%ly ULONG64 Adresse im virtuellen Adressraum des Prozesses eines Elements mit Symbolinformationen. Zeichenfolge, die den Namen des angegebenen Symbols (und ggf. Verschiebung) sowie alle verfügbaren Quellzeileninformationen enthält.
 

Wenn FormatNULL ist, wird nur der Standardeingabeaufforderungstext an die Ausgaberückrufe gesendet.

...

Gibt zusätzliche Parameter an, die Werte darstellen, die während der Formatierung in die Ausgabe eingefügt werden sollen.

Rückgabewert

Rückgabecode BESCHREIBUNG
S_OK
Die Methode war erfolgreich.
 

Diese Methode kann auch Fehlerwerte zurückgeben. Weitere Informationen finden Sie unter Rückgabewerte .

Hinweise

OutputPrompt und OutputPromptWide können verwendet werden, um den Benutzer zur Eingabe aufzufordern.

Die Standardeingabeaufforderung wird an die Ausgaberückrufe vor dem formatierten Text gesendet, der durch Format beschrieben wird. Der Inhalt der Standardeingabeaufforderung wird von der GetPromptText-Methode zurückgegeben.

Der Eingabeaufforderungstext wird mit festgelegtem DEBUG_OUTPUT_PROMPT Ausgabemaske an die Ausgaberückrufe gesendet.

Weitere Informationen zum Auffordern des Benutzers finden Sie unter Verwenden von Eingabe und Ausgabe.

Anforderungen

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

Weitere Informationen

ControlledOutput

DEBUG_OUTPUT_XXX

GetPromptText

IDebugControl

IDebugControl2

IDebugControl3

OutputPromptVaList