NSTServiceEntry
适用于:Outlook 2013 | Outlook 2016
MAPI 存储提供程序的消息服务入口点函数,用于将基于 PST 的本地存储包装为 NST 存储。
快速信息
属性 | 值 |
---|---|
实现者: |
MAPI 提供程序 |
调用者: |
MAPI |
HRESULT NSTServiceEntry(
HINSTANCE hInstance,
LPMALLOC lpMalloc,
LPMAPISUP lpMAPISup,
ULONG ulUIParam,
ULONG ulFlags,
ULONG ulContext,
ULONG cValues,
LPSPropValue lpProps,
LPPROVIDERADMIN lpProviderAdmin,
LPMAPIERROR FAR * lppMapiError
);
参数
NSTServiceEntry 使用 MSGSERVICEENTRY 函数原型。 有关其参数的信息,请参阅 MSGSERVICEENTRY。
返回值
有关返回值的信息,请参阅 MSGSERVICEENTRY。
备注
使用 GetProcAddress 在 msmapi32.dll 中查找此函数的地址时,请指定“NSTServiceEntry”作为过程名称。
若要使用复制 API,MAPI 存储提供程序必须首先通过调用 NSTServiceEntry 打开并包装基于 PST 的本地存储。 然后,提供程序可以使用 API、 IOSTX 和 IPSTX 的主要接口来执行复制。
以下备注适用于 NST 存储:
实现使用 NSTServiceEntry 的 MAPI 提供程序时,请勿在全局配置文件部分存储任何信息。 全局配置文件部分由许多提供程序共享,可以覆盖存储在此配置文件中的数据。
只有具有现有修改时间戳的项才会在保存时更新其标记。
保存项目时,不会自动发生冲突检查。
保存项目时不会发生重复检测。
表示服务器的缓存版本的文件追加了 。NST。
若要获取指向全局配置文件部分的指针,消息服务使用 pbNSTGlobalProfileSectionGuid 调用支持对象中的 IMAPISupport::OpenProfileSection,如下所示:
#define pbNSTGlobalProfileSectionGuid "\x85\xED\x14\x23\x9D\xF7\x42\x66\x8B\xF2\xFB\xD4\xA5\x21\x29\x41"
在这种情况下,消息服务的支持对象应确保 IMAPISupport::OpenProfileSection 返回由默认配置文件部分中 的 PR_SERVICE_UID 属性标识的配置文件部分。 若要获取此配置文件部分,支持对象可以打开默认配置文件部分,检索 PR_SERVICE_UID,并将结果传递给 IMAPISupport::OpenProfileSection 以检索正确的全局配置文件部分。 支持对象反过来又返回指向消息服务的此全局配置文件部分的指针。