IMAPISupport::RegisterPreprocessor
Hace referencia a: Outlook 2013 | Outlook 2016
Registra la función de preprocesador de un proveedor de transporte (una función que se ajusta al prototipo de PreprocessMessage ).
HRESULT RegisterPreprocessor(
LPMAPIUID lpMuid,
LPSTR lpszAdrType,
LPSTR lpszDLLName,
LPSTR lpszPreprocess,
LPSTR lpszRemovePreprocessInfo,
ULONG ulFlags
);
Parameters
lpMuid
[in] Puntero a la estructura MAPIUID que contiene el identificador que controla la función de preprocesador. El parámetro lpMuid puede ser NULL.
lpszAdrType
[in] Puntero al tipo de dirección de los mensajes en los que funciona la función, como FAX, SMTP o X500. El parámetro lpszAdrType puede ser NULL.
lpszDLLName
[in] Puntero al nombre de la biblioteca de vínculos dinámicos (DLL) que contiene el punto de entrada de la función de preprocesador.
lpszPreprocess
[in] Puntero al nombre de la función de preprocesador. El parámetro lpszPreprocess puede ser NULL.
lpszRemovePreprocessInfo
[in] Puntero al nombre de la función que quita la información del preprocesador (una función que se ajusta al prototipo RemovePreprocessInfo ). El parámetro lpszRemovePreprocessInfo puede ser NULL.
ulFlags
Reservados; debe ser cero.
Valor devuelto
S_OK
La función de preprocesador se registró correctamente.
Comentarios
El método IMAPISupport::RegisterPreprocessor se implementa solo para los objetos de soporte técnico del proveedor de transporte. Los proveedores de transporte llaman a RegisterPreprocessor para registrar una función de preprocesador (una función que se ajusta al prototipo de PreprocessMessage ). Se debe registrar una función de preprocesador para que la cola MAPI pueda llamarla.
Los parámetros lpszPreprocess, lpszRemovePreprocessInfo y lpszDLLName deben apuntar a cadenas que se pueden usar junto con llamadas a la función GetProcAddress de Win32, lo que permite llamar correctamente al punto de entrada DLL del preprocesador.
Notas para los llamadores
Las llamadas a preprocesadores son específicas del orden del proveedor de transporte. Esto significa que si otro proveedor de transporte delante de su proveedor es capaz de controlar un mensaje, no se llamará a la función de preprocesador para ese mensaje. Se llamará a la función de preprocesador solo para los mensajes que controlará.
Puede escribir funciones de preprocesador para controlar un identificador específico almacenado en una estructura MAPIUID o un tipo de dirección. Si especifica una estructura MAPIUID en el parámetro lpMuid y un tipo de dirección en el parámetro lpszAdrType , se llamará a la función para destinatarios de mensajes que coincidan con MAPIUID o con el tipo de dirección. Si lpMuid es NULL y lpszAdrType no es NULL, solo se llamará a la función para los destinatarios que tengan una dirección que coincida con el tipo al que apunta lpszAdrType. Si lpMuid no es NULL y lpszAdrType es NULL, se llamará a la función para los destinatarios que coincidan con MAPIUID, independientemente de su tipo de dirección. Si ambos son NULL, se llama a la función para todos los destinatarios del mensaje.
Vea también
MAPIUID
PreprocessMessage
RemovePreprocessInfo
IMAPISupport: IUnknown