Compartilhar via


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

Confira também

Conceitual

Referência

StringCbPrintf

StringCbPrintfEx

StringCbVPrintf

StringCbVPrintfEx

StringCchPrintf

StringCchPrintfEx

StringCchVPrintf

StringCchVPrintfEx

Cadeias de caracteres

wsprintf