NSTServiceEntry
Gilt für: Outlook 2013 | Outlook 2016
Nachrichtendiensteinstiegspunktfunktion für einen MAPI-Speicheranbieter zum Umschließen eines PST-basierten lokalen Speichers als NST-Speicher.
QuickInfo
| Eigenschaft | Wert |
|---|---|
| Implementiert von: |
MAPI-Anbieter |
| Aufgerufen von: |
MAPI |
HRESULT NSTServiceEntry(
HINSTANCE hInstance,
LPMALLOC lpMalloc,
LPMAPISUP lpMAPISup,
ULONG ulUIParam,
ULONG ulFlags,
ULONG ulContext,
ULONG cValues,
LPSPropValue lpProps,
LPPROVIDERADMIN lpProviderAdmin,
LPMAPIERROR FAR * lppMapiError
);
Parameter
NSTServiceEntry verwendet den Funktionsprototyp MSGSERVICEENTRY . Informationen zu den Parametern finden Sie unter MSGSERVICEENTRY.
Rückgabewerte
Informationen zu Rückgabewerten finden Sie unter MSGSERVICEENTRY.
Hinweise
Wenn Sie GetProcAddress verwenden, um nach der Adresse dieser Funktion in msmapi32.dll zu suchen, geben Sie "NSTServiceEntry" als Prozedurnamen an.
Um die Replikations-API verwenden zu können, muss ein MAPI-Speicheranbieter zuerst einen PST-basierten lokalen Speicher öffnen und umschließen, indem er NSTServiceEntry aufruft. Der Anbieter kann dann die Hauptschnittstellen der API, IOSTX und IPSTX, verwenden, um die Replikation durchzuführen.
Die folgenden Hinweise gelten für einen NST-Speicher:
Speichern Sie keine Informationen im Abschnitt "Globales Profil", wenn Sie einen MAPI-Anbieter implementieren, der NSTServiceEntry verwendet. Der globale Profilabschnitt wird von vielen Anbietern gemeinsam genutzt, und in diesem Profil gespeicherte Daten können überschrieben werden.
Nur Elemente mit vorhandenen Änderungszeitstempeln werden beim Speichern aktualisiert.
Die Konfliktüberprüfung erfolgt nicht automatisch, wenn Elemente gespeichert werden.
Beim Speichern von Elementen tritt keine Duplikaterkennung auf.
Die Datei, die die zwischengespeicherte Version des Servers darstellt, wird mit angefügt. NST.
Um einen Zeiger auf den globalen Profilabschnitt zu erhalten, ruft ein Nachrichtendienst IMAPISupport::OpenProfileSection im Supportobjekt auf, indem pbNSTGlobalProfileSectionGuid wie unten definiert verwendet wird:
#define pbNSTGlobalProfileSectionGuid "\x85\xED\x14\x23\x9D\xF7\x42\x66\x8B\xF2\xFB\xD4\xA5\x21\x29\x41"In diesem Fall sollte das Supportobjekt des Nachrichtendiensts sicherstellen, dass IMAPISupport::OpenProfileSection den Profilabschnitt zurückgibt, der durch die PR_SERVICE_UID-Eigenschaft im Standardprofilabschnitt identifiziert wird. Um diesen Profilabschnitt abzurufen, kann das Supportobjekt den Standardprofilabschnitt öffnen, PR_SERVICE_UID abrufen und das Ergebnis an IMAPISupport::OpenProfileSection übergeben, um den richtigen globalen Profilabschnitt abzurufen. Das Supportobjekt gibt wiederum einen Zeiger auf diesen globalen Profilabschnitt an den Nachrichtendienst zurück.