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、 IOSTXIPSTX 的主要接口来执行复制。

以下备注适用于 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 以检索正确的全局配置文件部分。 支持对象反过来又返回指向消息服务的此全局配置文件部分的指针。

另请参阅

关于复制 API