_Deref_和_Outptr_ sal注解

Question

Deref和Outptr注释之间有什么区别？此外，您何时使用不同类型的Outptr注释，如_Outptr_result_buffer_all_和_Outptr_result_buffer_

Answer 1

SAL的文献记录不多。您需要查看sal.h文件。

Deref和Outptr SAL注释的区别是什么？

它们是相同的，只不过Deref注释来自SAL 1，Outptr来自SAL 2(这可以表示更多)。所以Deref不受欢迎了。

另外，您何时使用不同类型的Outptr注释，如_Outptr_result_buffer_all_和_Outptr_result_buffer_？

引用Sal.h的话：

Outptr:返回的变量是指针类型(所以param是指针到指针类型)。调用函数提供/分配空间。

从源代码来看，_Outptr_result_buffer_和_Outptr_result_buffer_all_几乎是一样的。您可以作为参数提供将要分配的元素数(如果它正好是一个元素，则使用_Outptr_)。不同之处在于，前者意味着调用方可以写元素(隐式地表示它们也是可读的)，而后者则意味着元素仅可读。

查看C运行时源，只有_Outptr_result_buffer_在极少数地方使用，例如。用于在_dupenv_s中创建的缓冲区

_Check_return_opt_ _CRTIMP errno_t __cdecl _dupenv_s(
    Outptr_result_buffer_maybenull_(*_PBufferSizeInBytes) _Outptr_result_z_ char **_PBuffer,
    _Out_opt_ size_t * _PBufferSizeInBytes,
    _In_z_ const char * _VarName);

因此，这个函数在_PBuffer中创建了一个(以空结尾的)缓冲区。缓冲区的大小可以在*_PBufferSizeInBytes中找到。