Função wvnsprintfA (shlwapi.h)
Usa uma lista de argumentos e retorna os valores dos argumentos como uma cadeia de caracteres formatada no estilo printf.
Sintaxe
int wvnsprintfA(
[out] PSTR pszDest,
[in] int cchDest,
[in] PCSTR pszFmt,
[in] va_list arglist
);
Parâmetros
[out] pszDest
Tipo: PTSTR
Um ponteiro para um buffer que, quando essa função retorna com êxito, recebe a cadeia de caracteres de saída.
[in] cchDest
Tipo: int
O número máximo de caracteres permitido no pszDest.
[in] pszFmt
Tipo: PCTSTR
Uma cadeia de caracteres de formato de estilo printf. O identificador de formato %s nunca deve ser usado em um formulário não associado. Para evitar possíveis estouros de buffer, especifique sempre um tamanho; por exemplo, "%32s".
[in] arglist
Tipo: va_list
Um ponteiro para uma lista de parâmetros de linha de comando usados para personalizar a saída.
Retornar valor
Tipo: int
Retorna o número de caracteres gravados no buffer, excluindo todos os caracteres NULL de terminação. Um valor negativo será retornado se ocorrer um erro.
Comentários
Aviso de segurança: Usar essa função incorretamente pode comprometer a segurança do aplicativo. Não há garantia de que a cadeia de caracteres copiada seja terminada em nulo. Considere usar uma das alternativas a seguir. StringCbPrintf, StringCbPrintfEx, StringCbVPrintf, StringCbVPrintfEx, StringCchPrintf, StringCchPrintfEx, StringCchVPrintf ou StringCchVPrintfEx. Você deve examinar considerações de segurança: Microsoft Windows Shell antes de continuar.
Observação
O cabeçalho shlwapi.h define wvnsprintf 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
Requisito | Valor |
---|---|
Cliente mínimo com suporte | Windows 2000 Professional, Windows XP [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 | shlwapi.h |
Biblioteca | Shlwapi.lib |
DLL | Shlwapi.dll (versão 5.0 ou posterior) |