Função wvsprintfA (winuser.h)
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 encerramento em sua contagem de caracteres.
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 de retorno
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 encerramento.
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.
Observações
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.
Nota
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 do pré-processador UNICODE. A combinação do uso do alias neutro de codificação com código que não é neutro em codificação pode levar a incompatibilidades que resultam em erros de compilação ou de runtime. Para obter mais informações, consulte Conventions for Function Prototypes.
Requisitos
| Requisito | Valor |
|---|---|
| de cliente com suporte mínimo | Windows 2000 Professional [somente aplicativos da área de trabalho] |
| servidor com suporte mínimo | Windows 2000 Server [somente aplicativos da área de trabalho] |
| da Plataforma de Destino |
Windows |
| cabeçalho | winuser.h (inclua Windows.h) |
| biblioteca | User32.lib |
| de DLL |
User32.dll |
Consulte também
Conceitual
de referência de