IAddrBook::NewEntry
适用于：Outlook 2013 | Outlook 2016
将新收件人添加到通讯簿容器或传出邮件的收件人列表中。
HRESULT NewEntry(
ULONG_PTR ulUIParam,
ULONG ulFlags,
ULONG cbEIDContainer,
LPENTRYID lpEIDContainer,
ULONG cbEIDNewEntryTpl,
LPENTRYID lpEIDNewEntryTpl,
ULONG FAR * lpcbEIDNewEntry,
LPENTRYID FAR * lppEIDNewEntry
);
参数
ulUIParam
[in]对话框的父窗口的句柄。
ulFlags
[in]控制所用文本类型的标志的位掩码。 可以设置以下标志：
MAPI_UNICODE
传入的字符串采用 Unicode 格式。 如果未设置MAPI_UNICODE标志，则字符串采用 ANSI 格式。
cbEIDContainer
[in] lpEIDContainer 参数指向的条目标识符中的字节计数。
lpEIDContainer
[in]指向要在其中添加新收件人的容器的条目标识符的指针。 如果 cbEIDContainer 参数为零， 则 NewEntry 方法将返回收件人条目标识符和模板列表，就像调用 了 IAddrBook：：CreateOneOff 方法一样。
cbEIDNewEntryTpl
[in] lpEIDNewEntryTpl 参数指向的条目标识符中的字节计数。
lpEIDNewEntryTpl
[in]指向将用于创建新收件人的一次性模板的指针。 如果 cbEIDNewEntryTpl 为零， lpEIDNewEntryTpl 为 NULL， 则 NewEntry 将显示一个对话框，用户可以使用该对话框从模板列表中选择用于添加新条目。
lEIDNewEntry
[out]指向 lppEIDNewEntry 参数指向的条目标识符中的字节计数的指针。
lppEIDNewEntry
[out]指向指向新收件人条目标识符的指针的指针的指针。
返回值
S_OK
已成功创建新的通讯簿条目。
备注
NewEntry 方法创建一个新的通讯簿条目，该条目将直接添加到容器中，或用于处理传出消息。
给调用方的说明
如果希望将新条目添加到特定容器，请将 lpEIDContainer 设置为容器的条目标识符，将 cbEIDContainer 设置为条目标识符中的字节计数。
如果要将新条目添加到传出邮件的收件人列表中，请将 lpEIDContainer 设置为 NULL，将 cbEIDContainer 设置为零。
如果要允许客户端应用程序的用户选择要创建的条目类型，请在 cbEIDNewEntryTpl 中传递零，在 lpEIDNewEntryTpl 中传递 NULL。 NewEntry 方法显示 MAPI 一次性表，这是 MAPI 和会话中每个通讯簿提供程序支持的模板列表。 每个模板可以为一个或多个地址类型创建收件人条目。
如果要保留新条目的条目标识符，请在 lEIDNewEntry 和 lppEIDNewEntry 参数中传递有效的指针。 通过调用 MAPIFreeBuffer 函数，负责释放此条目标识符。
若要使用特定模板向可修改容器添加新条目，请使用以下过程：
调用 IMAPISession：：OpenEntry 方法以打开目标容器，并将 lpEntryID 参数设置为容器的入口标识符。
调用目标容器的 IMAPIProp：：OpenProperty 方法，并将 ulPropTag 参数设置为 PR_CREATE_TEMPLATES (PidTagCreateTemplates) 和 lpiid 参数以IID_IMAPITable。 容器将返回一个一次性表，其中列出了它支持创建新条目的所有模板。
检索表示要创建的特定类型的条目的模板的行。 PR_ADDRTYPE (PidTagAddressType) 列指示模板支持的地址类型。
调用 NewEntry 方法，并将 lpEIDNewEntryTpl 设置为所选模板的条目标识符。 条目标识符将是一次性表中模板行中的 PR_ENTRYID (PidTagEntryId) 列。 在 cbEIDContainer 中传递零，在 lpEIDContainer 中传递 NULL。 如果要保留新条目的条目标识符，请传递 lppEIDNewEntry 参数中的有效指针。