Примечание.
Для доступа к этой странице требуется авторизация. Вы можете попробовать войти или изменить каталоги.
Для доступа к этой странице требуется авторизация. Вы можете попробовать изменить каталоги.
Метод outputPromptVaList форматирует и отправляет пользователю запрос на объекты обратного вызова.
Синтаксис
HRESULT OutputPromptVaList(
[in] ULONG OutputControl,
[in, optional] PCSTR Format,
[in] va_list Args
);
Параметры
[in] OutputControl
Указывает выходной элемент управления, определяющий, какие из выходных вызовов клиента будут получать выходные данные. Возможные значения см. в разделе DEBUG_OUTCTL_XXX.
[in, optional] Format
Указывает строку формата, как в printf. Как правило, символы преобразования работают точно так же, как и в C. Для символов преобразования с плавающей запятой 64-разрядный аргумент интерпретируется как 32-разрядное число с плавающей запятой, если не используется модификатор l.
Символ преобразования %p поддерживается, но он представляет указатель в адресном пространстве целевого объекта. Он может не иметь модификаторов и использует внутреннее форматирование адресов отладчика. Поддерживаются следующие дополнительные символы преобразования.
| Характер | Тип аргумента | Аргумент | Печатный текст |
|---|---|---|---|
| %p | ULONG64 | Указатель в адресном пространстве. | Значение указателя. |
| %N | DWORD_PTR (32 или 64 бита в зависимости от архитектуры узла) | Указатель на виртуальное адресное пространство узла. | Значение указателя. (Это эквивалентно стандартному символу C %p.) |
| %I | ULONG64 | Любое 64-разрядное значение. | Указанное значение. Если это больше 0xFFFFFFFF, оно выводится в виде 64-разрядного значения; в противном случае он печатается как 32-разрядное значение. |
| %ma | ULONG64 | Адрес строки ASCII, завершаемой null, в виртуальном адресном пространстве процесса. | Указанная строка. |
| %mu | ULONG64 | Адрес строки Юникода, завершаемой null, в виртуальном адресном пространстве процесса. | Указанная строка. |
| %msa | ULONG64 | Адрес структуры ANSI_STRING в виртуальном адресном пространстве процесса. | Указанная строка. |
| %msu | ULONG64 | Адрес структуры UNICODE_STRING в виртуальном адресном пространстве процесса. | Указанная строка. |
| %y | ULONG64 | Адрес в виртуальном адресном пространстве процесса элемента с информацией о символах. | Строка, содержащая имя указанного символа (и смещение, если таковое есть). |
| %ly | ULONG64 | Адрес в виртуальном адресном пространстве процесса элемента с информацией о символах. | Строка, содержащая имя указанного символа (и смещения, если таковые имеются), а также любые доступные сведения о исходной строке. |
Если форматNULL, то в выходные обратные вызовы отправляется только стандартный текст запроса.
[in] Args
Указывает дополнительные параметры, представляющие значения, которые будут вставлены в выходные данные во время форматирования. Args необходимо инициализировать с помощью va_start. Этот метод не вызывает va_end.
Возвращаемое значение
Этот метод также может возвращать значения ошибок. Дополнительные сведения см. в возвращаемых значений.
| Возвращаемый код | Описание |
|---|---|
|
Метод был успешным. |
Замечания
OutputPromptVaList и OutputPromptVaListWide можно использовать для запроса пользователя на ввод.
Стандартный запрос будет отправлен в выходные обратные вызовы перед форматированным текстом, описанным Format. Содержимое стандартного запроса возвращается методом GetPromptText.
Текст запроса отправляется в выходные обратные вызовы с набором маски вывода DEBUG_OUTPUT_PROMPT.
Дополнительные сведения о запросе пользователя см. в разделе Using Input and Output.
Требования
| Требование | Ценность |
|---|---|
| целевая платформа | Настольный |
| заголовка | dbgeng.h (include Dbgeng.h, Stdarg.h) |