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