C28741

aviso C28741: Buffer não anotado na função

Esse aviso indica que um buffer passado como um parâmetro de função ou retornado por uma função deve ser anotado com a linguagem de anotação de código-fonte (SAL) da Microsoft. As ferramentas de análise estática podem usar essas anotações para detetar saturações de buffer.

Atualmente, apenas buffers de cadeia de caracteres não constantes são diagnosticados com esse aviso. Idealmente, todos os buffers passados como parâmetros de função ou retornados por funções devem ser anotados. Matrizes de wchar_t ou char são candidatos a este aviso. Caracteres não assinados atualmente não são.

Exemplo

O código a seguir exemplo gera esse aviso.

  int foo( LPTSTR buffer, size_t cch );

O exemplo de código a seguir evita esse aviso usando o _out_writes_ de anotação SAL para especificar que a função chamada grava no buffer e que o buffer não pode ser NULL. A anotação indica que o buffer é de cch elementos.

    int foo(_Out_writes_(cch) LPTSTR buffer, size_t cch );