IAddrBook::CreateOneOff


		Contents Index Topic Contents
	Previous Topic: IAddrBook::CopyTo Next Topic: IAddrBook::DeleteProps

IAddrBook::CreateOneOff
HRESULT CreateOneOff(
    LPTSTR lpszName,
    LPTSTR lpszAdrType,
    LPTSTR lpszAddress,
    ULONG ulFlags,
    ULONG FAR * lpcbEntryID,
    LPENTRYID FAR * lppEntryID
);
Creates an entry identifier for a one-off address.
Returns S_OK if the one-off entry identifier was created successfully.

lpszName
Pointer to the display name of the recipient. The lpszName parameter can be NULL. the PR_DISPLAY_NAME property. The lpszName parameter can be NULL.
lpszAdrType
Pointer to the address type of the recipient, such as FAX or SMTP. The lpszAdrType parameter cannot be NULL.
lpszAddress
Pointer to the address of the recipient. The lpszAddress parameter cannot be NULL.
ulFlags
Bitmask of flags that affect the one-off recipient. The following flags can be set:

MAPI_SEND_NO_RICH_INFO Indicates the recipient cannot handle formatted message content. If MAPI_SEND_NO_RICH_INFO is set, MAPI sets the recipient's PR_SEND_RICH_INFO property to FALSE. If MAPI_SEND_NO_RICH_INFO is not set, MAPI sets this property to TRUE unless the recipient's messaging address pointed to by lpszAddress is interpreted to be an Internet address. In this case, MAPI sets PR_SEND_RICH_INFO to FALSE.

MAPI_UNICODE Displays the name, address type, and address are in Unicode format. If the MAPI_UNICODE flag is not set, these strings are in ANSI format.

lpcbEntryID
Address of the count of bytes in the entry identifier pointed to by the lppEntryID parameter.
lppEntryID
Address of a pointer to the entry identifier for the one-off recipient.

Back to top

Top of Page
© 1997 Microsoft Corporation. All rights reserved. Terms of Use.

MAPI_SEND_NO_RICH_INFO	Indicates the recipient cannot handle formatted message content. If MAPI_SEND_NO_RICH_INFO is set, MAPI sets the recipient's PR_SEND_RICH_INFO property to FALSE. If MAPI_SEND_NO_RICH_INFO is not set, MAPI sets this property to TRUE unless the recipient's messaging address pointed to by lpszAddress is interpreted to be an Internet address. In this case, MAPI sets PR_SEND_RICH_INFO to FALSE.
MAPI_UNICODE	Displays the name, address type, and address are in Unicode format. If the MAPI_UNICODE flag is not set, these strings are in ANSI format.