NSTServiceEntry
Hace referencia a: Outlook 2013 | Outlook 2016
Función de punto de entrada del servicio de mensajes para que un proveedor de almacén MAPI ajuste un almacén local basado en PST como un almacén NST.
Información rápida
| Propiedad | Valor |
|---|---|
| Implementado por: |
Proveedor MAPI |
| Llamado por: |
MAPI |
HRESULT NSTServiceEntry(
HINSTANCE hInstance,
LPMALLOC lpMalloc,
LPMAPISUP lpMAPISup,
ULONG ulUIParam,
ULONG ulFlags,
ULONG ulContext,
ULONG cValues,
LPSPropValue lpProps,
LPPROVIDERADMIN lpProviderAdmin,
LPMAPIERROR FAR * lppMapiError
);
Parameters
NSTServiceEntry usa el prototipo de función MSGSERVICEENTRY . Para obtener información sobre sus parámetros, vea MSGSERVICEENTRY.
Valores devueltos
Para obtener información sobre los valores devueltos, vea MSGSERVICEENTRY.
Comentarios
Al usar GetProcAddress para buscar la dirección de esta función en msmapi32.dll, especifique "NSTServiceEntry" como nombre del procedimiento.
Para usar la API de replicación, un proveedor de almacén MAPI primero debe abrir y encapsular un almacén local basado en PST llamando a NSTServiceEntry. A continuación, el proveedor puede usar las interfaces principales de la API, IOSTX e IPSTX, para llevar a cabo la replicación.
Los siguientes comentarios se aplican a un almacén de NST:
No almacene ninguna información en la sección de perfil global al implementar un proveedor MAPI que use NSTServiceEntry. Muchos proveedores comparten la sección de perfil global y los datos almacenados en este perfil se pueden sobrescribir.
Solo los elementos con marcas de tiempo de modificación existentes obtienen sus sellos actualizados cuando se guardan.
La comprobación de conflictos no se produce automáticamente cuando se guardan los elementos.
La detección de duplicados no se produce cuando se guardan los elementos.
El archivo que representa la versión almacenada en caché del servidor se anexa con . NST.
Para obtener un puntero a la sección de perfil global, un servicio de mensajes llama a IMAPISupport::OpenProfileSection en el objeto de soporte técnico mediante pbNSTGlobalProfileSectionGuid como se define a continuación:
#define pbNSTGlobalProfileSectionGuid "\x85\xED\x14\x23\x9D\xF7\x42\x66\x8B\xF2\xFB\xD4\xA5\x21\x29\x41"En este caso, el objeto de soporte técnico del servicio de mensajes debe asegurarse de que IMAPISupport::OpenProfileSection devuelve la sección de perfil identificada por la propiedad PR_SERVICE_UID en la sección de perfil predeterminado. Para obtener esta sección de perfil, el objeto de soporte técnico puede abrir la sección de perfil predeterminada, recuperar PR_SERVICE_UID y pasar el resultado a IMAPISupport::OpenProfileSection para recuperar la sección de perfil global correcta. A su vez, el objeto de compatibilidad devuelve un puntero a esta sección de perfil global al servicio de mensajes.