IABLogon::GetOneOffTable
This content is outdated and is no longer being maintained. It is provided as a courtesy for individuals who are still using these technologies. This page may contain URLs that were valid when originally published, but now link to sites or pages that no longer exist.
Returns a table of one-off templates for creating recipients to be added to the recipient list of an outgoing message.
HRESULT GetOneOffTable(
ULONG ulFlags,
LPMAPITABLE FAR * lppTable
);
Parameters
ulFlags
[in] A bitmask of flags that controls the type of string columns included in the table. The following flag can be set:- MAPI_UNICODE
The string columns are in Unicode format. If the MAPI_UNICODE flag is not set, the string columns are in ANSI format.
- MAPI_UNICODE
lppTable
[out] A pointer to a pointer to the one-off table.
Return Value
S_OK
The one-off table was successfully retrieved.MAPI_E_BAD_CHARWIDTH
Either the MAPI_UNICODE flag was set and the address book provider does not support Unicode, or MAPI_UNICODE was not set and the address book provider supports only Unicode.MAPI_E_NO_SUPPORT
The address book provider does not supply any one-off templates.
Remarks
MAPI calls the GetOneOffTable method to make available one-off templates to create recipients. The new recipients are added to the recipient list of an outgoing message. Address book providers should support notification on their one-off table to inform MAPI of template modifications. MAPI keeps the one-off table open to enable dynamic updating.
Address book providers can also support a one-off table for each of their containers. Callers retrieve this one-off table by calling the container's IMAPIProp::OpenProperty method and requesting the PR_CREATE_TEMPLATES (PidTagCreateTemplates) property. The templates available through this table are used to add recipients to the container. For a discussion of the differences between the two types of one-off tables, see Implementing One-Off Tables.
For a list of the required columns in an address book provider's one-off table, see One-Off Tables.