IMAPISupport::WrapStoreEntryID

项目
04/04/2023

适用于：Outlook 2013 | Outlook 2016

将消息存储的内部条目标识符转换为 MAPI 标准格式的条目标识符。

HRESULT WrapStoreEntryID(
ULONG cbOrigEntry,
LPENTRYID lpOrigEntry,
ULONG FAR * lpcbWrappedEntry,
LPENTRYID FAR * lppWrappedEntry
);

参数

cbOrigEntry

[in] lpOrigEntry 参数指向的条目标识符中的字节计数。

lpOrigEntry

[in]指向消息存储的专用条目标识符的指针。

lWrappedEntry

[out]指向 lppWrappedEntry 参数指向的条目标识符中的字节计数的指针。

lppWrappedEntry

[out]指向指向已包装条目标识符的指针的指针。

返回值

S_OK

已成功包装条目标识符。

备注

为所有服务提供商支持对象实现 IMAPISupport：：WrapStoreEntryID 方法。服务提供商使用 WrapStoreEntryID 让 MAPI 为包装存储区内部条目标识符的消息存储生成条目标识符。

给调用方的说明

当客户端调用消息存储的 IMAPIProp：：GetProps 方法检索其 PR_STORE_ENTRYID (PidTagStoreEntryId) 属性，并且消息存储使用专用格式的条目标识符时，调用 WrapStoreEntryID 并返回 lppWrappedEntry 参数指向的条目标识符。

对 IMSProvider：：Logon 和 IMSLogon：：CompareEntryIDs 方法的调用始终获取存储的专用条目标识符;包装版本仅在客户端应用程序和 MAPI 之间使用。

使用完输入标识符后，通过使用 MAPIFreeBuffer 函数释放 lppWrappedEntry 参数指向的条目标识符的内存。