__in，__ out，__ in_opt的含义

Question

在函数参数中的变量之前使用这些关键字的含义是什么？

• __in
• __out
• __in_opt

Answer 1

这些是来自微软SAL Annotations的一些较旧的装饰宏（现在较新的装饰宏是按照不同的外壳，从首都开始）。 这些对编译没有实际影响（在VS 2010下它们甚至没有扩展），它们用于内联API文档。

1. __in ：此参数是函数的输入（只读，调用者已初始化）。
2. __out ：此参数包含函数返回时的输出（只写，调用者初始化）。
3. __in_opt ：由_in和_opt形成的复合注释， _opt表示该参数是可选的，可以设置为默认值（通常为NULL ）。

你可以在这里得到了充分的解释旧的装饰品在这里 。

Answer 2

正如Nercolis所回答的，这些是SAL注释属性。 但是，这些不仅仅是内部的，也不仅仅是API文档 。 真正的目的是进行代码分析 。 使用/ analyze编译器选项（项目属性，代码分析 - >常规）构建项目时，这些选项在查找编码问题中起着重要作用。

例如，如果特定指针参数显示__in则不得传递空指针。 该函数不会检查null并可能导致SEH。 __in_opt参数可以为null。 当编译器发现某些问题时，它会将其报告为警告。 看到这篇文章 。