C28741

varning C28741: Ej kommenterad buffert i funktionen

Den här varningen anger att en buffert som skickas som en funktionsparameter eller returneras av en funktion ska kommenteras med Microsoft Source Code Annotation Language (SAL). Statiska analysverktyg kan använda sådana anteckningar för att identifiera buffertöverskridanden.

För närvarande diagnostiseras endast icke-konstanta strängbuffertar med den här varningen. Helst bör alla buffertar som skickas som funktionsparametrar eller returneras av funktioner kommenteras. Matriser med wchar_t eller tecken är kandidater för den här varningen. Osignerade tecken är för närvarande inte det.

exempel

Koden i följande exempel genererar den här varningen.

  int foo( LPTSTR buffer, size_t cch );

I följande kodexempel undviker du den här varningen genom att använda SAL-kommentaren _Out_writes_ för att ange att den anropade funktionen skriver till bufferten och att bufferten inte kan vara NULL. Kommentaren anger att bufferten är av cch element.

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