Nota
O acesso a esta página requer autorização. Podes tentar iniciar sessão ou mudar de diretório.
O acesso a esta página requer autorização. Podes tentar mudar de diretório.
O método OutputPrompt formata e envia um prompt de usuário para os objetos de retorno de chamada de saída .
Sintaxe
HRESULT OutputPrompt(
[in] ULONG OutputControl,
[in, optional] PCSTR Format,
...
);
Parâmetros
[in] OutputControl
Especifica um controle de saída que determina quais dos retornos de chamada de saída do cliente receberão a saída. Para obter valores possíveis, consulte DEBUG_OUTCTL_XXX.
[in, optional] Format
Especifica a cadeia de caracteres de formato, como em 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.
O caractere de conversão %p tem suporte, 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.
| Personagem | 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 de %p C 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 é 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 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 Formatar 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.
Valor de retorno
| Código de retorno | Descrição |
|---|---|
|
O método foi bem-sucedido. |
Esse método também pode retornar valores de erro. Consulte de Valores Retornados para obter mais detalhes.
Observações
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 ao usuário, consulte Usandode Entrada e Saída.
Requisitos
| Requisito | Valor |
|---|---|
| da Plataforma de Destino | Área de trabalho |
| cabeçalho | dbgeng.h (inclua Dbgeng.h) |