IDebugControl::OutputPromptVaList-Methode (dbgeng.h)

Artikel
02/06/2025

Die OutputPromptVaList Methoden formatiert und sendet eine Benutzeraufforderung an die Ausgaberückrufobjekte.

Syntax

HRESULT OutputPromptVaList(
  [in]           ULONG   OutputControl,
  [in, optional] PCSTR   Format,
  [in]           va_list Args
);

Parameter

[in] OutputControl

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

[in, optional] Format

Gibt die Formatzeichenfolge wie in printf-an. 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 jedoch einen Zeiger im Adressraum eines Ziels dar. Möglicherweise gibt es 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 Bit, abhängig von der Architektur des Hosts)	Zeiger im virtuellen Adressbereich des Hosts.	Der Wert des Zeigers. (Dies entspricht dem Standardzeichen C %p.)
%I	ULONG64	Ein beliebiger 64-Bit-Wert.	Der angegebene Wert. Wenn dies größer als 0xFFFFFFFF ist, wird sie als 64-Bit-Wert gedruckt; andernfalls wird sie als 32-Bit-Wert gedruckt.
%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 Adressbereich des Prozesses eines Elements mit Symbolinformationen.	Zeichenfolge, die den Namen des angegebenen Symbols (und Verschiebung, falls vorhanden) enthält.
%ly	ULONG64	Adresse im virtuellen Adressbereich des Prozesses eines Elements mit Symbolinformationen.	Zeichenfolge, die den Namen des angegebenen Symbols (und Verschiebung, falls vorhanden) sowie alle verfügbaren Quellzeileninformationen enthält.

Wenn Format-NULL-ist, wird nur der Standardeingabeaufforderungstext an die Ausgaberückrufe gesendet.

[in] Args

Gibt zusätzliche Parameter an, die Werte darstellen, die während der Formatierung in die Ausgabe eingefügt werden sollen. Args muss mithilfe von va_startinitialisiert werden. Diese Methode ruft va_endnicht auf.

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.

Bemerkungen

OutputPromptVaList und OutputPromptVaListWide kann verwendet werden, um den Benutzer zur Eingabe aufzufordern.

Die Standardaufforderung wird an die Ausgaberückrufe gesendet, bevor der formatierte Text, der von Formatbeschrieben wird. Der Inhalt der Standardaufforderung wird von der Methode GetPromptText-zurückgegeben.

Der Eingabeaufforderungstext wird an die Ausgaberückrufe mit dem DEBUG_OUTPUT_PROMPT Ausgabeformatsatz gesendet.

Weitere Informationen zum Anfordern des Benutzers finden Sie unter Using Input and Output.