MAPIDETAILS-Rückruffunktion (mapi.h)

Artikel
08/24/2023

[Die Verwendung dieser Funktion wird abgeraten. Sie kann in nachfolgenden Versionen von Windows geändert oder nicht verfügbar sein.]

Die MAPIDetails-Funktion zeigt ein Dialogfeld an, das die Details eines ausgewählten Adresslisteneintrags enthält.

Syntax

MAPIDETAILS Mapidetails;

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

Parameter

[in] lhSession

Sitzungshandle, das eine einfache MAPI-Sitzung oder null darstellt. Wenn der Wert des lhSession-Parameters null ist, meldet sich die MAPI beim Benutzer an und erstellt eine Sitzung, die nur für die Dauer des Aufrufs vorhanden ist. Bei dieser temporären Sitzung kann es sich um eine vorhandene freigegebene Sitzung oder eine neue Sitzung handelt. Wenn der Benutzer zusätzliche Informationen benötigt, um die Anmeldung erfolgreich abzuschließen, wird ein Dialogfeld angezeigt.

[in] ulUIParam

Ziehpunkt des übergeordneten Fensters oder null, was angibt, dass es sich bei der Anzeige eines Dialogfelds um eine modale Anwendung handelt. Wenn der ulUIParam-Parameter ein übergeordnetes Fensterhandle enthält, ist er vom Typ HWND (in eine ULONG_PTR umgewandelt). Wenn während des Aufrufs kein Dialogfeld angezeigt wird, wird ulUIParam ignoriert.

[in] lpRecip

Zeiger auf den Empfänger, für den Details angezeigt werden sollen. MAPIDetails ignoriert alle Member dieser MapiRecipDesc-Struktur mit Ausnahme der Member ulEIDSize und lpEntryID . Wenn der Wert von ulEIDSize ungleich null ist, löst MAPIDetails den Empfängereintrag auf. Wenn der Wert von ulEIDSize null ist, gibt MAPIDetails den MAPI_E_AMBIGUOUS_RECIP Wert zurück.

[in] flFlags

Bitmaske von Optionsflags. Die folgenden Flags können festgelegt werden.

Wert	Bedeutung
MAPI_AB_NOMODIFY	Der Aufrufer fordert an, dass das Dialogfeld schreibgeschützt ist, wodurch Änderungen verhindert werden. MAPIDetails kann die Anforderung berücksichtigen oder nicht.
MAPI_LOGON_UI	Es sollte ein Dialogfeld angezeigt werden, in dem der Benutzer bei Bedarf aufgefordert wird, sich anzumelden. Wenn das flag MAPI_LOGON_UI nicht festgelegt ist, zeigt die Clientanwendung kein Anmeldedialogfeld an und gibt einen Fehlerwert zurück, wenn der Benutzer nicht angemeldet ist.
MAPI_NEW_SESSION	Es sollte versucht werden, eine neue Sitzung zu erstellen, anstatt die freigegebene Sitzung der Umgebung zu erhalten. Wenn das flag MAPI_NEW_SESSION nicht festgelegt ist, verwendet MAPIDetails eine vorhandene freigegebene Sitzung.

ulReserved

Reserviert; muss null sein.

Rückgabewert

Diese Funktion gibt einen der folgenden Werte zurück.

Rückgabecode	Beschreibung
MAPI_E_AMBIGUOUS_RECIPIENT	Das Dialogfeld konnte nicht angezeigt werden, weil der ulEIDSize-Member der Struktur, auf die der parameter lpRecips verweist, null war.
MAPI_E_FAILURE	Mindestens ein nicht angegebener Fehler ist aufgetreten. Es wurde kein Dialogfeld angezeigt.
MAPI_E_INSUFFICIENT_MEMORY	Es war nicht genügend Arbeitsspeicher vorhanden, um fortzufahren. Es wurde kein Dialogfeld angezeigt.
MAPI_E_INVALID_RECIPS	Der im lpRecip-Parameter angegebene Empfänger war unbekannt, oder der Empfänger hatte einen ungültigen ulEIDSize-Wert . Es wurde kein Dialogfeld angezeigt.
MAPI_E_LOGIN_FAILURE	Es gab keine Standardanmeldung, und der Benutzer konnte sich nicht erfolgreich anmelden, wenn das Anmeldedialogfeld angezeigt wurde. Es wurde kein Dialogfeld angezeigt.
MAPI_E_NOT_SUPPORTED	Der Vorgang wurde vom zugrunde liegenden Messagingsystem nicht unterstützt.
MAPI_E_USER_ABORT	Der Benutzer hat entweder das Anmeldedialogfeld oder das Detaildialogfeld abgebrochen.
SUCCESS_SUCCESS	Der Aufruf war erfolgreich, und das Detaildialogfeld wurde angezeigt.

Hinweise

Die MAPIDetails-Funktion zeigt ein Dialogfeld an, in dem die Details eines bestimmten Adresslisteneintrags angezeigt werden. Der Anzeigename und die Adresse sind die minimalen Attribute, die im Dialogfeld angezeigt werden. Je nach Adressbuchanbieter können weitere Informationen angezeigt werden. Das Detaildialogfeld kann nicht unterdrückt werden, aber der Aufrufer kann anfordern, dass es schreibgeschützt oder änderbar ist.

Details können nur für aufgelöste Adresslisteneinträge angezeigt werden. Ein Eintrag wird aufgelöst, wenn der Wert des ulEIDSize-Elements der MapiRecipDesc-Struktur ungleich null ist. Einträge werden aufgelöst, wenn sie von den Funktionen MAPIAddress oder MAPIResolveName zurückgegeben werden und als Ergebnis Empfänger von Lese-E-Mails sind.