IMAPISupport::RegisterPreprocessor

Article
04/04/2023

S’applique à : Outlook 2013 | Outlook 2016

Inscrit la fonction de préprocesseur d’un fournisseur de transport (fonction conforme au prototype PreprocessMessage ).

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

Paramètres

lpMuid

[in] Pointeur vers la structure MAPIUID qui contient l’identificateur géré par la fonction de préprocesseur. Le paramètre lpMuid peut être NULL.

lpszAdrType

[in] Pointeur vers le type d’adresse pour les messages sur lesquels la fonction opère, tels que FAX, SMTP ou X500. Le paramètre lpszAdrType peut être NULL.

lpszDLLName

[in] Pointeur vers le nom de la bibliothèque de liens dynamiques (DLL) qui contient le point d’entrée de la fonction de préprocesseur.

lpszPreprocess

[in] Pointeur vers le nom de la fonction de préprocesseur. Le paramètre lpszPreprocess peut être NULL.

lpszRemovePreprocessInfo

[in] Pointeur vers le nom de la fonction qui supprime les informations de préprocesseur (fonction conforme au prototype RemovePreprocessInfo ). Le paramètre lpszRemovePreprocessInfo peut être NULL.

ulFlags

Réservés au; doit être égal à zéro.

Valeur renvoyée

S_OK

La fonction de préprocesseur a été inscrite avec succès.

Remarques

La méthode IMAPISupport ::RegisterPreprocessor est implémentée pour les objets de prise en charge du fournisseur de transport uniquement. Les fournisseurs de transport appellent RegisterPreprocessor pour inscrire une fonction de préprocesseur (fonction conforme au prototype PreprocessMessage ). Une fonction de préprocesseur doit être inscrite avant que le spouleur MAPI puisse l’appeler.

Les paramètres lpszPreprocess, lpszRemovePreprocessInfo et lpszDLLName doivent tous pointer vers des chaînes qui peuvent être utilisées conjointement avec les appels à la fonction Win32 GetProcAddress , ce qui permet au point d’entrée DLL du préprocesseur d’être appelé correctement.

Remarques pour les appelants

Les appels aux préprocesseurs sont spécifiques à la commande du fournisseur de transport. Cela signifie que si un autre fournisseur de transport en avance sur votre fournisseur est en mesure de gérer un message, votre fonction de préprocesseur n’est pas appelée pour ce message. Votre fonction de préprocesseur sera appelée uniquement pour les messages que vous allez gérer.

Vous pouvez écrire des fonctions de préprocesseur pour gérer un identificateur spécifique stocké dans une structure MAPIUID ou un type d’adresse. Si vous spécifiez à la fois une structure MAPIUID dans le paramètre lpMuid et un type d’adresse dans le paramètre lpszAdrType , votre fonction est appelée pour les destinataires de messages qui correspondent au MAPIUID ou au type d’adresse. Si lpMuid a la valeur NULL et que lpszAdrType n’est pas NULL, votre fonction est appelée uniquement pour les destinataires dont l’adresse correspond au type désigné par lpszAdrType. Si lpMuid n’a pas la valeur NULL et que lpszAdrType a la valeur NULL, votre fonction est appelée pour les destinataires qui correspondent à MAPIUID, quel que soit leur type d’adresse. Si les deux sont NULL, votre fonction est appelée pour tous les destinataires du message.

Voir aussi

MAPIUID
PreprocessMessage
RemovePreprocessInfo
IMAPISupport : IUnknown

Partager via