windows - 我们应该使用 _In_ 而不是 __in 吗？

Question

我今天阅读了 VS2010 中的 sal.h。
我有点惊讶。

// This section contains the deprecated annotations
|------------|------------|---------|--------|----------|----------|---------------|
|   Level    |   Usage    |  Size   | Output | NullTerm | Optional |  Parameters   |
|------------|------------|---------|--------|----------|----------|---------------|
| <>         | <>         | <>      | <>     | _z       | <>       | <>            |
| _deref     | _in        | _ecount | _full  | _nz      | _opt     | (size)        |
| _deref_opt | _out       | _bcount | _part  |          |          | (size,length) |
|            | _inout     |         |        |          |          |               |
|            |            |         |        |          |          |               |
|------------|------------|---------|--------|----------|----------|---------------|

我一直使用这些注释。
我无法相信它们已被弃用。是真的吗？
如果是，为什么？
我们应该从现在开始使用以下注释吗？ -我不熟悉:(

|--------------|----------|----------------|-----------------------------|
|   Usage      | Nullness | ZeroTerminated |  Extent                     |
|--------------|----------|----------------|-----------------------------|
| _In_         | <>       | <>             | <>                          |
| _Out_        | opt_     | z_             | [byte]cap_[c_|x_]( size )   |
| _Inout_      |          |                | [byte]count_[c_|x_]( size ) |
| _Deref_out_  |          |                | ptrdiff_cap_( ptr )         |
|--------------|          |                | ptrdiff_count_( ptr )       |
| _Ret_        |          |                |                             |
| _Deref_ret_  |          |                |                             |
|--------------|          |                |                             |
| _Pre_        |          |                |                             |
| _Post_       |          |                |                             |
| _Deref_pre_  |          |                |                             |
| _Deref_post_ |          |                |                             |
|--------------|----------|----------------|-----------------------------|

顺便说一下，SO 中不存在 SAL 标签。
如果可以，请做到这一点。

Answer 1

看来你应该习惯新的“attribute”SAL格式了，见本文中间的红色评论:

Link