Описание тега microsoft-sal

Язык аннотации исходного кода Microsoft или SAL предоставляет встроенный метод для документирования функций API уровня источника с помощью макросов, предоставляемых sal.h заголовок.

Эти макросы используются для украшения аргументов функции и возвращаемых типов, обеспечивая указание различных свойств, таких как необязательность, нулевое завершение или размер буфера. Ниже приведен пример использования аннотаций SAL (взятых из MSDN):

void MyPaintingFunction(
    __in HWND hwndControl,      // An initialized read-only parameter.
    __in_opt HDC hdcOptional,   // An initialized read-only parameter
                                //  that might be NULL.
    __inout IPropertyStore *ppsStore  // An initialized parameter that
                                // may be freeely used and modified.
);

Начиная с Visual Studio 2008, макросы теперь стандартизированы для использования заглавных букв.

• Текущая документация SAL
• Документация SAL старого стиля