Função wvsprintfA (winuser.h)

Artigo
03/15/2023

Grava dados formatados no buffer especificado usando um ponteiro para uma lista de argumentos. Os itens apontados pela lista de argumentos são convertidos e copiados para um buffer de saída de acordo com a especificação de formato correspondente na cadeia de caracteres de controle de formato. A função acrescenta um caractere nulo de terminação aos caracteres que grava, mas o valor retornado não inclui o caractere nulo de terminação em sua contagem de caracteres.

Aviso Não use. Considere usar uma das seguintes funções: StringCbVPrintf, StringCbVPrintfEx, StringCchVPrintf ou StringCchVPrintfEx. Confira Considerações de segurança.

Sintaxe

int wvsprintfA(
  [out] LPSTR   unnamedParam1,
  [in]  LPCSTR  unnamedParam2,
  [in]  va_list arglist
);

Parâmetros

[out] unnamedParam1

Tipo: LPTSTR

O buffer que deve receber a saída formatada. O tamanho máximo do buffer é de 1.024 bytes.

[in] unnamedParam2

Tipo: LPCTSTR

As especificações de controle de formato. Além dos caracteres ASCII comuns, uma especificação de formato para cada argumento aparece nesta cadeia de caracteres. Para obter mais informações sobre a especificação de formato, consulte a função wsprintf .

[in] arglist

Tipo: va_list

Cada elemento dessa lista especifica um argumento para a cadeia de caracteres de controle de formato. O número, o tipo e a interpretação dos argumentos dependem das especificações de controle de formato correspondentes no parâmetro lpFmt .

Valor retornado

Tipo: int

Se a função for bem-sucedida, o valor retornado será o número de caracteres armazenados no buffer, sem contar o caractere nulo de terminação.

Se a função falhar, o valor retornado será menor que o comprimento da saída esperada. Para obter informações de erro estendidas, chame GetLastError.

Comentários

A função copia a cadeia de caracteres de controle de formato para o caractere de buffer de saída por caractere, começando com o primeiro caractere na cadeia de caracteres. Quando encontra uma especificação de formato na cadeia de caracteres, a função recupera o valor do próximo argumento disponível (começando com o primeiro argumento na lista), converte esse valor no formato especificado e copia o resultado para o buffer de saída. A função continua copiando caracteres e expandindo as especificações de formato dessa maneira até chegar ao final da cadeia de caracteres de controle de formato. Se houver mais argumentos do que especificações de formato, os argumentos extras serão ignorados. Se não houver argumentos suficientes para todas as especificações de formato, os resultados serão indefinidos.

Observação

O cabeçalho winuser.h define wvsprintf como um alias que seleciona automaticamente a versão ANSI ou Unicode dessa função com base na definição da constante de pré-processador UNICODE. Misturar o uso do alias neutro de codificação com código que não seja neutro em codificação pode levar a incompatibilidades que resultam em erros de compilação ou de runtime. Para obter mais informações, consulte Convenções para protótipos de função.

Requisitos


Cliente mínimo com suporte	Windows 2000 Professional [somente aplicativos da área de trabalho]
Servidor mínimo com suporte	Windows 2000 Server [somente aplicativos da área de trabalho]
Plataforma de Destino	Windows
Cabeçalho	winuser.h (inclua Windows.h)
Biblioteca	User32.lib
DLL	User32.dll