IMAPISupport::CreateOneOff
适用于：Outlook 2013 | Outlook 2016
为一次性地址创建入口标识符。
HRESULT CreateOneOff(
LPSTR lpszName,
LPSTR lpszAdrType,
LPSTR lpszAddress,
ULONG ulFlags,
ULONG FAR * lpcbEntryID,
LPENTRYID FAR * lppEntryID
);
参数
lpszName
[in]指向收件人显示名称的指针， (PidTagDisplayName) 属性PR_DISPLAY_NAME。 lpszName 参数可以为 NULL。
lpszAdrType
[in]指向收件人的地址类型 (（例如 FAX、SMTP 或 X500) ）的指针。 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
已成功创建一次性条目标识符。
备注
为所有服务提供商支持对象实现 IMAPISupport：：CreateOneOff 方法。 服务提供商调用 CreateOneOff 为一次性收件人创建条目标识符， (不属于当前加载的任何通讯簿提供程序) 的任何容器的收件人。
给调用方的说明
使用 完 CreateOneOff 返回的条目标识符后，使用 MAPIFreeBuffer 函数释放为条目标识符分配的内存。
传输提供程序说明
支持传输中性封装格式 (TNEF) 并使用 PR_SEND_RICH_INFO 属性的值来确定在传输消息时是否使用 TNEF。 对于需要自定义 MAPI 属性的基于表单的客户端或客户端，不支持 TNEF 或在请求时不以此格式发送消息可能是一个问题。 这是因为 TNEF 通常用于发送自定义消息类的自定义属性。