A client application calls the MAPIAddress function to generate a list of recipients for a message. If some of the recipients are known already, for example when forwarding a message, you can pass in an initial array of MapiRecipDesc structures which the user can then modify.
MAPIAddress always displays a dialog box where the user can modify the list of recipients. If you need to generate a recipient list without presenting a dialog box, get recipients' names or addresses through some other means — by calling the MAPIResolveName function if necessary.
A successful call to the MAPIAddress function produces a buffer containing one or more MapiRecipDesc structures that you must release with the MAPIFreeBuffer function when the buffer is no longer needed.