Qual è la differenza tra __deref_out_opt e __deref_opt_out?

Question

Qual è la differenza tra le seguenti annotazioni SAL?

void foo(__deref_out_opt PSTR* bar); 

void foo(__deref_opt_out PSTR* bar); 

Answer 1

Un parametro PSTR* fuori significa il chiamante passa in un buffer che riceve un puntatore a una stringa.

In __deref_out_opt, la stringa è opzionale (funzione mette NULL nel buffer del chiamante fornito).

In __deref_opt_out, il buffer è facoltativa (il chiamante passa NULL per indicare disinteresse il valore di uscita).

Presumibilmente, è possibile combinare questi concetti, ci dovrebbe essere un modificatore __deref_opt_out_opt per quello.