NSTServiceEntry
Aplica-se a: Outlook 2013 | Outlook 2016
Função de ponto de entrada do serviço de mensagem para um provedor de loja MAPI para encerrar um repositório local baseado em PST como um repositório NST.
Informações rápidas
| Propriedade | Valor |
|---|---|
| Implementado por: |
Provedor MAPI |
| Chamado 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
);
Parâmetros
NSTServiceEntry usa o protótipo da função MSGSERVICEENTRY . Para obter informações sobre seus parâmetros, consulte MSGSERVICEENTRY.
Valores de retorno
Para obter informações sobre valores retornados, consulte MSGSERVICEENTRY.
Comentários
Ao usar GetProcAddress para procurar o endereço dessa função em msmapi32.dll, especifique "NSTServiceEntry" como o nome do procedimento.
Para usar a API de Replicação, um provedor de repositório MAPI deve primeiro abrir e encerrar um repositório local baseado em PST chamando NSTServiceEntry. Em seguida, o provedor pode usar as principais interfaces da API, IOSTX e IPSTX para realizar a replicação.
As seguintes observações se aplicam a um repositório NST:
Não armazene nenhuma informação na seção perfil global ao implementar um provedor MAPI que usa o NSTServiceEntry. A seção perfil global é compartilhada por muitos provedores e os dados armazenados neste perfil podem ser substituídos.
Somente itens com carimbos de tempo de modificação existentes recebem seus selos atualizados quando são salvos.
A verificação de conflitos não ocorre automaticamente quando os itens são salvos.
A detecção duplicada não ocorre quando os itens são salvos.
O arquivo que representa a versão armazenada em cache do servidor é acrescentado com . NST.
Para obter um ponteiro para a seção perfil global, um serviço de mensagem chama IMAPISupport::OpenProfileSection no objeto de suporte usando pbNSTGlobalProfileSectionGuid conforme definido abaixo:
#define pbNSTGlobalProfileSectionGuid "\x85\xED\x14\x23\x9D\xF7\x42\x66\x8B\xF2\xFB\xD4\xA5\x21\x29\x41"Nesse caso, o objeto de suporte do serviço de mensagem deve garantir que IMAPISupport::OpenProfileSection retorne a seção de perfil identificada pela propriedade PR_SERVICE_UID na seção perfil padrão. Para obter essa seção de perfil, o objeto de suporte pode abrir a seção de perfil padrão, recuperar PR_SERVICE_UID e passar o resultado para IMAPISupport::OpenProfileSection para recuperar a seção de perfil global correta. O objeto de suporte, por sua vez, retorna um ponteiro para esta seção de perfil global para o serviço de mensagem.