windows - __deref_out_opt 和 __deref_opt_out 有什么区别？

Question

下面的SAL有什么区别？注释？

void foo(__deref_out_opt PSTR* bar);

void foo(__deref_opt_out PSTR* bar);

Answer 1

PSTR* out 参数意味着调用者传入一个缓冲区，该缓冲区接收指向字符串的指针。

在 __deref_out_opt 中，字符串是可选的(该函数将 NULL 放入调用者提供的缓冲区中)。

在 __deref_opt_out 中，缓冲区是可选的(调用者传递 NULL 表示对输出值不感兴趣)。

据推测，可以将这些概念结合起来，应该有一个 __deref_opt_out_opt 修饰符。