HrGetOneProp

Article
04/04/2023

S’applique à : Outlook 2013 | Outlook 2016

Récupère la valeur d’une propriété unique à partir d’une interface de propriété, c’est-à-dire d’une interface dérivée de IMAPIProp.

Propriété	Valeur
Fichier d’en-tête :	Mapiutil.h
Implémenté par :	MAPI
Appelé par :	Applications clientes et fournisseurs de services

HRESULT HrGetOneProp(
  LPMAPIPROP pmp,
  ULONG ulPropTag,
  LPSPropValue FAR * ppprop
);

Paramètres

Pmp

[in] Pointeur vers l’interface IMAPIProp à partir de laquelle la valeur de propriété doit être récupérée.

ulPropTag

[in] Balise de propriété de la propriété à récupérer.

ppprop

[out] Pointeur vers un pointeur vers la structure SPropValue retournée définissant la valeur de propriété récupérée.

Valeur renvoyée

MAPI_E_NOT_FOUND

La propriété demandée n’est pas disponible à partir de l’interface spécifiée.

Remarques

Contrairement à la méthode IMAPIProp ::GetProps , la fonction HrGetOneProp ne retourne jamais d’avertissement. Étant donné qu’il ne récupère qu’une seule propriété, il réussit ou échoue. Pour récupérer plusieurs propriétés, GetProps est plus rapide.

Vous pouvez définir ou modifier une propriété unique avec la fonction HrSetOneProp .

Référence MFCMAPI

Pour voir un exemple de code MFCMAPI, consultez le tableau suivant.

Fichier	Fonction	Commentaire
MAPIFunctions.cpp	GetMAPIObjectType	MFCMAPI utilise la méthode HrGetOneProp pour récupérer le type d’un objet.

Voir aussi

MFCMAPI comme un exemple de Code

Partager via