IAddrBook::CreateOneOff
适用于：Outlook 2013 | Outlook 2016
为一次性地址创建入口标识符。
HRESULT CreateOneOff(
LPSTR lpszName,
LPSTR lpszAdrType,
LPSTR lpszAddress,
ULONG ulFlags,
ULONG FAR * lpcbEntryID,
LPENTRYID FAR * lppEntryID
);
参数
lpszName
[in]指向收件人 PR_DISPLAY_NAME 的值的指针， (PidTagDisplayName) 属性。 lpszName 参数可以为 NULL。
lpszAdrType
[in]指向收件人地址类型的指针，例如 FAX 或 SMTP。 lpszAdrType 参数不能为 NULL。
lpszAddress
[in]指向收件人地址的指针。 lpszAddress 参数不能为 NULL。
ulFlags
[in]影响一次性收件人的标志的位掩码。 可以设置以下标志：
MAPI_SEND_NO_RICH_INFO
收件人无法处理带格式的邮件内容。 如果设置了MAPI_SEND_NO_RICH_INFO，MAPI 会将收件人的 PR_SEND_RICH_INFO (PidTagSendRichInfo) 属性设置为 FALSE。 如果未设置MAPI_SEND_NO_RICH_INFO，MAPI 会将此属性设置为 TRUE，除非 lpszAddress 指向的收件人的邮件地址被解释为 Internet 地址。 在这种情况下，MAPI 将PR_SEND_RICH_INFO 设置为 FALSE。
MAPI_UNICODE
显示名称、地址类型和地址采用 Unicode 格式。 如果未设置MAPI_UNICODE标志，则这些字符串采用 ANSI 格式。
l恩特利ID
[out]指向 lppEntryID 参数指向的条目标识符中的字节计数的指针。
lppEntryID
[out]指向指向一次性收件人条目标识符的指针的指针。
返回值
S_OK
已成功创建一次性条目标识符。
备注
客户端调用 CreateOneOff 方法，为一次性收件人创建条目标识符，该收件人不属于任何当前加载的通讯簿提供程序中的任何容器。 一次性收件人可以拥有会话的活动通讯簿提供商之一支持的任何类型的地址。
一次性收件人通常是使用其特定地址类型的模板创建的。 支持地址类型的通讯簿提供程序提供模板。 客户端应用程序的用户在模板中输入相关信息。
MAPI 支持 用于 CreateOneOff 的显示名称、地址类型和地址参数的 Unicode 字符串。
MAPI_SEND_NO_RICH_INFO标志控制是否随每封邮件一起发送 RTF (RTF) 格式的格式化文本。 传输中性封装格式 (TNEF) （一种用于传输格式化文本的格式）由大多数传输提供程序发送，而不管收件人如何设置其 PR_SEND_RICH_INFO 属性。 对于处理人际消息的邮件客户端来说，这不是问题。 但是，由于 TNEF 通常用于发送自定义消息类的自定义属性，因此对于需要自定义 MAPI 属性的基于表单的客户端或客户端来说，不支持它可能是一个问题。 有关详细信息，请参阅 使用 TNEF 发送消息。
MFCMAPI 引用
有关 MFCMAPI 示例代码，请参阅下表。
| 文件 | 函数 | Comment |
|---|---|---|
| Mapiabfunctions.cpp |
AddOneOffAddress |
MFCMAPI 使用 CreateOneOff 方法为在任何通讯簿中找不到的地址创建条目 ID。 |