Função wnsprintfA (shlwapi.h)

Usa uma lista de argumentos de comprimento variável e retorna os valores dos argumentos como uma cadeia de caracteres formatada no estilo printf.

Sintaxe

int wnsprintfA(
  [out] PSTR  pszDest,
  [in]  int   cchDest,
  [in]  PCSTR pszFmt,
        ...   
);

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 permitidos 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, sempre especifique um tamanho; por exemplo, "%32s".

...

Parâmetros adicionais que contêm os dados a serem gerados.

Retornar valor

Tipo: int

Retorna o número de caracteres gravados no buffer, excluindo quaisquer 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.

Esta é uma versão do Windows do sprintf. Ele não dá suporte a tipos de ponteiro ou ponto flutuante. Ele dá suporte apenas ao sinalizador de alinhamento esquerdo.

Requisitos