Compartilhar via


Método IDebugControl4::OutputPromptWide (dbgeng.h)

O método OutputPromptWide formata e envia um prompt de usuário para os objetos de retorno de chamada de saída.

Sintaxe

HRESULT OutputPromptWide(
  [in]           ULONG  OutputControl,
  [in, optional] PCWSTR Format,
                 ...    
);

Parâmetros

[in] OutputControl

Especifica um controle de saída que determina qual dos retornos de chamada de saída do cliente receberá a saída. Para obter valores possíveis, consulte DEBUG_OUTCTL_XXX.

[in, optional] Format

Especifica a cadeia de caracteres de formato, como no printf. Normalmente, os caracteres de conversão funcionam exatamente como em C. Para os caracteres de conversão de ponto flutuante, o argumento de 64 bits é interpretado como um número de ponto flutuante de 32 bits, a menos que o modificador l seja usado.

Há suporte para o caractere de conversão %p , mas representa um ponteiro no espaço de endereço de um destino. Ele pode não ter modificadores e usa a formatação de endereço interno do depurador. Há suporte para os seguintes caracteres de conversão adicionais.

Caractere Tipo de argumento Argumento Texto impresso
%p ULONG64 Ponteiro em um espaço de endereço. O valor do ponteiro.
%N DWORD_PTR (32 ou 64 bits, dependendo da arquitetura do host) Ponteiro no espaço de endereço virtual do host. O valor do ponteiro. (Isso é equivalente ao caractere C %p padrão.)
%I ULONG64 Qualquer valor de 64 bits. O valor especificado. Se for maior que 0xFFFFFFFF, ele será impresso como um valor de 64 bits; caso contrário, ele será impresso como um valor de 32 bits.
%ma ULONG64 Endereço de uma cadeia de caracteres ASCII terminada em NULL no espaço de endereço virtual do processo. A cadeia de caracteres especificada.
%mu ULONG64 Endereço de uma cadeia de caracteres Unicode terminada em NULL no espaço de endereço virtual do processo. A cadeia de caracteres especificada.
%msa ULONG64 Endereço de uma estrutura ANSI_STRING no espaço de endereço virtual do processo. A cadeia de caracteres especificada.
%msu ULONG64 Endereço de uma estrutura de UNICODE_STRING no espaço de endereço virtual do processo. A cadeia de caracteres especificada.
%y ULONG64 Endereço no espaço de endereço virtual do processo de um item com informações de símbolo. Cadeia de caracteres que contém o nome do símbolo especificado (e deslocamento, se houver).
%ly ULONG64 Endereço no espaço de endereço virtual do processo de um item com informações de símbolo. Cadeia de caracteres que contém o nome do símbolo especificado (e deslocamento, se houver), bem como qualquer informação de linha de origem disponível.
 

Se Format for NULL, somente o texto do prompt padrão será enviado para os retornos de chamada de saída.

...

Especifica parâmetros adicionais que representam valores a serem inseridos na saída durante a formatação.

Retornar valor

Código de retorno Descrição
S_OK
O método foi bem-sucedido.
 

Esse método também pode retornar valores de erro. Consulte Valores retornados para obter mais detalhes.

Comentários

OutputPrompt e OutputPromptWide podem ser usados para solicitar entrada ao usuário.

O prompt padrão será enviado para os retornos de chamada de saída antes do texto formatado descrito por Format. O conteúdo do prompt padrão é retornado pelo método GetPromptText.

O texto do prompt é enviado para os retornos de chamada de saída com o conjunto de máscaras de saída DEBUG_OUTPUT_PROMPT.

Para obter mais informações sobre como solicitar o usuário, consulte Usando Entrada e Saída.

Requisitos

Requisito Valor
Plataforma de Destino Área de Trabalho
Cabeçalho dbgeng.h (inclua Dbgeng.h)

Confira também

Controlledoutput

DEBUG_OUTPUT_XXX

GetPromptText

IDebugControl4

OutputPromptVaList