IMAPISupport::RegisterPreprocessor

Artigo
04/04/2023

Aplica-se a: Outlook 2013 | Outlook 2016

Registra a função de pré-processador de um provedor de transporte (uma função que está em conformidade com o protótipo PreprocessMessage ).

HRESULT RegisterPreprocessor(
LPMAPIUID lpMuid,
LPSTR lpszAdrType,
LPSTR lpszDLLName,
LPSTR lpszPreprocess,
LPSTR lpszRemovePreprocessInfo,
ULONG ulFlags
);

Parâmetros

lpMuid

[in] Um ponteiro para a estrutura MAPIUID que contém o identificador que a função pré-processador manipula. O parâmetro lpMuid pode ser NULL.

lpszAdrType

[in] Um ponteiro para o tipo de endereço para as mensagens em que a função opera, como FAX, SMTP ou X500. O parâmetro lpszAdrType pode ser NULL.

lpszDLLName

[in] Um ponteiro para o nome da DLL (biblioteca de link dinâmico) que contém o ponto de entrada da função de pré-processador.

lpszPreprocess

[in] Um ponteiro para o nome da função de pré-processador. O parâmetro lpszPreprocess pode ser NULL.

lpszRemovePreprocessInfo

[in] Um ponteiro para o nome da função que remove informações do pré-processador (uma função que está em conformidade com o protótipo RemovePreprocessInfo ). O parâmetro lpszRemovePreprocessInfo pode ser NULL.

ulFlags

Reservados; deve ser zero.

Valor de retorno

S_OK

A função de pré-processador foi registrada com êxito.

Comentários

O método IMAPISupport::RegisterPreprocessor é implementado apenas para objetos de suporte do provedor de transporte. Os provedores de transporte chamam RegisterPreprocessor para registrar uma função de pré-processador (uma função que está em conformidade com o protótipo PreprocessMessage ). Uma função de pré-processador deve ser registrada antes que o spooler MAPI possa chamá-la.

Os parâmetros lpszPreprocess, lpszRemovePreprocessInfo e lpszDLLName devem apontar para cadeias de caracteres que podem ser usadas em conjunto com chamadas para a função Win32 GetProcAddress , permitindo que o ponto de entrada DLL do pré-processador seja chamado corretamente.

Notas para chamadores

As chamadas para pré-processadores são específicas para a ordem do provedor de transporte. Isso significa que, se outro provedor de transporte à frente do provedor for capaz de lidar com uma mensagem, sua função de pré-processador não será chamada para essa mensagem. Sua função de pré-processador será chamada apenas para mensagens que você tratará.

Você pode gravar funções de pré-processador para manipular um identificador específico armazenado em uma estrutura MAPIUID ou um tipo de endereço. Se você especificar uma estrutura MAPIUID no parâmetro lpMuid e um tipo de endereço no parâmetro lpszAdrType , sua função será chamada para destinatários de mensagens que correspondam ao MAPIUID ou ao tipo de endereço. Se lpMuid for NULL e lpszAdrType não for NULL, sua função será chamada apenas para destinatários que tenham um endereço que corresponda ao tipo apontado por lpszAdrType. Se lpMuid não for NULL e lpszAdrType for NULL, sua função será chamada para destinatários que correspondam a MAPIUID, independentemente do tipo de endereço. Se ambos forem NULL, sua função será chamada para todos os destinatários da mensagem.

Confira também

MAPIUID
PreprocessMessage
RemovePreprocessInfo
IMAPISupport: IUnknown

Compartilhar via