Fonction de rappel MAPIDETAILS (mapi.h)

[L’utilisation de cette fonction est déconseillée. Il peut être modifié ou indisponible dans les versions ultérieures de Windows.]

La fonction MAPIDetails affiche une boîte de dialogue contenant les détails d’une entrée de liste d’adresses sélectionnée.

Syntaxe

MAPIDETAILS Mapidetails;

ULONG Mapidetails(
  [in] LHANDLE lhSession,
  [in] ULONG_PTR ulUIParam,
  [in] lpMapiRecipDesc lpRecip,
  [in] FLAGS flFlags,
       ULONG ulReserved
)
{...}

Paramètres

[in] lhSession

Handle de session qui représente une session MAPI simple ou zéro. Si la valeur du paramètre lhSession est zéro, MAPI se connecte à l’utilisateur et crée une session qui existe uniquement pendant la durée de l’appel. Cette session temporaire peut être une session partagée existante ou une nouvelle. Si des informations supplémentaires sont requises de la part de l’utilisateur pour terminer l’ouverture de session, une boîte de dialogue s’affiche.

[in] ulUIParam

Poignée de fenêtre parente ou zéro, indiquant que si une boîte de dialogue s’affiche, il s’agit d’une application modale. Si le paramètre ulUIParam contient un handle de fenêtre parent, il est de type HWND (cast en ULONG_PTR). Si aucune boîte de dialogue n’est affichée pendant l’appel, ulUIParam est ignoré.

[in] lpRecip

Pointeur vers le destinataire pour lequel les détails doivent être affichés. MAPIDetails ignore tous les membres de cette structure MapiRecipDesc , à l’exception des membres ulEIDSize et lpEntryID . Si la valeur de ulEIDSize est différente de zéro, MAPIDetails résout l’entrée du destinataire. Si la valeur de ulEIDSize est zéro, MAPIDetails retourne la valeur MAPI_E_AMBIGUOUS_RECIP.

[in] flFlags

Masque de bits des indicateurs d’option. Les indicateurs suivants peuvent être définis.

Valeur	Signification
MAPI_AB_NOMODIFY	L’appelant demande que la boîte de dialogue soit en lecture seule, ce qui interdit les modifications. MAPIDetails peut ou non honorer la demande.
MAPI_LOGON_UI	Une boîte de dialogue doit s’afficher pour inviter l’utilisateur à se connecter si nécessaire. Lorsque l’indicateur MAPI_LOGON_UI n’est pas défini, l’application cliente n’affiche pas de boîte de dialogue d’ouverture de session et retourne une valeur d’erreur si l’utilisateur n’est pas connecté.
MAPI_NEW_SESSION	Une tentative de création d’une session doit être effectuée plutôt que d’acquérir la session partagée de l’environnement. Si l’indicateur MAPI_NEW_SESSION n’est pas défini, MAPIDetails utilise une session partagée existante.

ulReserved

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

Valeur retournée

Cette fonction retourne l’une des valeurs suivantes.

Code de retour	Description
MAPI_E_AMBIGUOUS_RECIPIENT	La boîte de dialogue n’a pas pu être affichée, car le membre ulEIDSize de la structure pointée par le paramètre lpRecips était égal à zéro.
MAPI_E_FAILURE	Une ou plusieurs erreurs non spécifiées se sont produites. Aucune boîte de dialogue n’a été affichée.
MAPI_E_INSUFFICIENT_MEMORY	La mémoire était insuffisante pour continuer. Aucune boîte de dialogue n’a été affichée.
MAPI_E_INVALID_RECIPS	Le destinataire spécifié dans le paramètre lpRecip était inconnu ou le destinataire avait une valeur ulEIDSize non valide. Aucune boîte de dialogue n’a été affichée.
MAPI_E_LOGIN_FAILURE	Il n’y avait pas d’ouverture de session par défaut et l’utilisateur n’a pas réussi à se connecter lorsque la boîte de dialogue d’ouverture de session s’affichait. Aucune boîte de dialogue n’a été affichée.
MAPI_E_NOT_SUPPORTED	L’opération n’était pas prise en charge par le système de messagerie sous-jacent.
MAPI_E_USER_ABORT	L’utilisateur a annulé la boîte de dialogue d’ouverture de session ou la boîte de dialogue détails.
SUCCESS_SUCCESS	L’appel a réussi et la boîte de dialogue des détails s’est affichée.

Notes

La fonction MAPIDetails présente une boîte de dialogue qui affiche les détails d’une entrée de liste d’adresses particulière. Le nom d’affichage et l’adresse sont les attributs minimaux affichés dans la boîte de dialogue ; des informations supplémentaires peuvent être affichées, en fonction du fournisseur du carnet d’adresses. La boîte de dialogue détails ne peut pas être supprimée, mais l’appelant peut demander qu’elle soit en lecture seule ou modifiable.

Les détails ne peuvent être affichés que pour les entrées de liste d’adresses résolues. Une entrée est résolue si la valeur du membre ulEIDSize de la structure MapiRecipDesc est différente de zéro. Les entrées sont résolues lorsqu’elles sont retournées par les fonctions MAPIAddress ou MAPIResolveName et qu’elles sont par conséquent des destinataires de courrier en lecture.

Spécifications

Plateforme cible	Windows
En-tête	mapi.h

Voir aussi

MAPIAddress

MAPILogon

MAPIResolveName

MapiRecipDesc

Simple MAPI