Método IDebugControl3::OutputPromptVaList (dbgeng.h)

Artigo
02/26/2024

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

Sintaxe

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

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.

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 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.

[in] Args

Especifica parâmetros adicionais que representam valores a serem inseridos na saída durante a formatação. Os argumentos devem ser inicializados usando va_start. Esse método não chama va_end.

Retornar valor

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

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

Comentários

OutputPromptVaList e OutputPromptVaListWide 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.