C28722

varning C28722: Ej kommenterad buffert i funktionsdeklaration

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 vid kompileringstillfället.

För närvarande diagnostiseras endast icke-konstanta buffertar med den här varningen.

exempel

Följande kodexempel 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 );