NSTServiceEntry

Статья
04/04/2023

Область применения: 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 должен сначала открыть и завернуть локальное хранилище на основе PST, вызвав NSTServiceEntry. Затем поставщик может использовать основные интерфейсы API, IOSTX и IPSTX, для выполнения репликации.

Следующие примечания относятся к хранилищу NST:

Не храните сведения в разделе глобального профиля при реализации поставщика MAPI, использующего NSTServiceEntry. Раздел глобального профиля совместно используется многими поставщиками, и данные, хранящиеся в этом профиле, могут быть перезаписаны.
При сохранении метки обновляются только элементы с существующими метками времени изменения.
Проверка конфликтов не выполняется автоматически при сохранении элементов.
Обнаружение повторяющихся данных не происходит при сохранении элементов.
Файл, представляющий кэшированную версию сервера, добавляется с . NST.
Чтобы получить указатель на раздел глобального профиля, служба сообщений вызывает IMAPISupport::OpenProfileSection в объекте поддержки с помощью pbNSTGlobalProfileSectionGuid , как определено ниже:
```
#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 репликации

Поделиться через