Microsoft отбросила язык аннотаций исходного кода (SAL) и соглашение о вызовах из определения их функций в MSDN - PullRequest
Новая
       103

Microsoft отбросила язык аннотаций исходного кода (SAL) и соглашение о вызовах из определения их функций в MSDN

2 голосов
/ 07 марта 2020

Например, определение функции SetWindowPos раньше было таким: 

BOOL WINAPI SetWindowPos(
  _In_      HWND hWnd,
  _In_opt_  HWND hWndInsertAfter,
  _In_      int X,
  _In_      int Y,
  _In_      int cx,
  _In_      int cy,
  _In_      UINT uFlags
);

Раньше это было очень ясно для соглашения о вызовах и какие параметры являются необязательными / in / out, et c.

Однако теперь MSDN делает это намного проще, но отбрасывает соглашение о вызовах и аннотации SAL следующим образом: 

BOOL SetWindowPos(
  HWND hWnd,
  HWND hWndInsertAfter,
  int  X,
  int  Y,
  int  cx,
  int  cy,
  UINT uFlags
);

Вопрос: Есть ли в любом случае, чтобы увидеть аннотации SAL и Соглашение о вызовах сейчас? Почему они решили удалить его?

...