Partager via

ValidateParms

  • Article

S’applique à : Outlook 2013 | Outlook 2016

Appelle une fonction interne pour case activée les paramètres que les applications clientes ont transmis aux fournisseurs de services.

Propriété Valeur
Fichier d’en-tête :
 Mapival.h
Implémenté par :
 MAPI
Appelé par :
 Fournisseurs de services
 
HRESULT ValidateParms(
  METHODS eMethod,
  LPVOID First
);

Paramètres

eMethod

[in] Spécifie, par énumération, la méthode à valider.

First

[in] Pointeur vers le premier argument de la pile.

Valeur renvoyée

S_OK

Tous les paramètres sont valides.

MAPI_E_CALL_FAILED

Un ou plusieurs paramètres ne sont pas valides.

Remarques

Les paramètres passés entre MAPI et les fournisseurs de services sont supposés être corrects et ne font l’objet que d’une validation de débogage avec la macro CheckParms . Les fournisseurs doivent case activée tous les paramètres transmis par les applications clientes, mais les clients doivent supposer que les paramètres MAPI et du fournisseur sont corrects. Utilisez la macro HR_FAILED pour tester les valeurs de retour.

ValidateParms est appelé différemment selon que le code appelant est C ou C++. C++ transmet un paramètre implicite appelé this à chaque appel de méthode, qui devient explicite en C et est l’adresse de l’objet. Le premier paramètre, eMethod, est un énumérateur créé à partir de l’interface et de la méthode en cours de validation et indique les paramètres à attendre sur la pile. Le deuxième paramètre est différent pour C et C++. En C++, il est appelé First, et il s’agit du premier paramètre de la méthode en cours de validation. Le deuxième paramètre du langage C, ppThis, est l’adresse du premier paramètre de la méthode qui est toujours un pointeur d’objet. Dans les deux cas, le deuxième paramètre donne l’adresse du début de la liste de paramètres de la méthode et, en fonction de la méthode eMethod, descend la pile et valide les paramètres.

Les fournisseurs implémentant des interfaces courantes telles que IMAPITable et IMAPIProp doivent toujours case activée paramètres à l’aide de la fonction ValidateParms afin de garantir la cohérence entre tous les fournisseurs. Des fonctions de validation de paramètre supplémentaires ont été définies pour certains types de paramètres complexes à utiliser à la place. Consultez les rubriques de référence pour les fonctions suivantes :

Les méthodes héritées utilisent la même validation de paramètre que l’interface dont elles héritent. Par exemple, la vérification des paramètres pour IMessage et IMAPIProp doit être identique.

Voir aussi

UlValidateParms