MAPIDETAILS-Rückruffunktion (mapi.h)
[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.
MAPIDETAILS Mapidetails;
ULONG Mapidetails(
[in] LHANDLE lhSession,
[in] ULONG_PTR ulUIParam,
[in] lpMapiRecipDesc lpRecip,
[in] FLAGS flFlags,
ULONG ulReserved
)
{...}
[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.
ulReserved
Reserviert; muss null sein.
Diese Funktion gibt einen der folgenden Werte zurück.
Rückgabecode | Beschreibung |
---|---|
|
Das Dialogfeld konnte nicht angezeigt werden, weil der ulEIDSize-Member der Struktur, auf die der parameter lpRecips verweist, null war. |
|
Mindestens ein nicht angegebener Fehler ist aufgetreten. Es wurde kein Dialogfeld angezeigt. |
|
Es war nicht genügend Arbeitsspeicher vorhanden, um fortzufahren. Es wurde kein Dialogfeld angezeigt. |
|
Der im lpRecip-Parameter angegebene Empfänger war unbekannt, oder der Empfänger hatte einen ungültigen ulEIDSize-Wert . Es wurde kein Dialogfeld angezeigt. |
|
Es gab keine Standardanmeldung, und der Benutzer konnte sich nicht erfolgreich anmelden, wenn das Anmeldedialogfeld angezeigt wurde. Es wurde kein Dialogfeld angezeigt. |
|
Der Vorgang wurde vom zugrunde liegenden Messagingsystem nicht unterstützt. |
|
Der Benutzer hat entweder das Anmeldedialogfeld oder das Detaildialogfeld abgebrochen. |
|
Der Aufruf war erfolgreich, und das Detaildialogfeld wurde angezeigt. |
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.
Zielplattform | Windows |
Kopfzeile | mapi.h |