__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修饰符。