Compartilhar via

Reserved Parameters

  • Artigo

Occasionally a function has a parameter that is intended for future use. The __reserved annotation ensures that in future versions, old callers to a function can be reliably detected. This annotation insists that the provided parameter be zero or NULL, as appropriate to the type.

For example, at some point the following function will take a second parameter, but all current use of that parameter should be coded with NULL. The following annotation enables PFD to confirm that current callers do not misuse the reserved parameter:

void do_stuff(struct a *pa, __reserved void *pb);

 

 

Send comments about this topic to Microsoft

Build date: 5/3/2011