Freigeben über


IAddrBook::Details

Gilt für: Outlook 2013 | Outlook 2016

Zeigt ein Dialogfeld an, in dem Details zu einem bestimmten Adressbucheintrag angezeigt werden.

HRESULT Details(
  ULONG_PTR FAR * lpulUIParam,
  LPFNDISMISS lpfnDismiss,
  LPVOID lpvDismissContext,
  ULONG cbEntryID,
  LPENTRYID lpEntryID,
  LPFNBUTTON lpfButtonCallback,
  LPVOID lpvButtonContext,
  LPSTR lpszButtonText,
  ULONG ulFlags
);

Parameter

lpulUIParam

[in] Ein Zeiger auf ein Handle des übergeordneten Fensters für das Dialogfeld.

lpfnDismiss

[in] Ein Zeiger auf eine Funktion, die auf dem DISMISSMODELESS-Prototyp basiert, oder NULL. Dieser Member gilt nur für die moduslose Version des Dialogfelds, wie durch das festgelegte DIALOG_SDI-Flag angegeben. MAPI ruft die DISMISSMODELESS-Funktion auf, wenn der Benutzer das Dialogfeld für die moduslose Adresse schließt und einen Client informiert, der Details aufruft, dass das Dialogfeld nicht mehr aktiv ist.

lpvDismissContext

[in] Ein Zeiger auf Kontextinformationen, die an die FUNKTION DISMISSMODELESS übergeben werden sollen, auf die der lpfnDismiss-Parameter zeigt. Dieser Parameter gilt nur für die moduslose Version des Dialogfelds, indem das flag DIALOG_SDI in den ulFlags-Parameter eingeschlossen wird.

cbEntryID

[in] Die Byteanzahl im Eintragsbezeichner, auf die der lpEntryID-Parameter verweist.

lpEntryID

[in] Ein Zeiger auf den Eintragsbezeichner für den Eintrag, für den Details angezeigt werden.

lpfButtonCallback

[in] Ein Zeiger auf eine Funktion, die auf dem Funktionsprototyp LPFNBUTTON basiert. Eine LPFNBUTTON-Funktion fügt dem Detaildialogfeld eine Schaltfläche hinzu.

lpvButtonContext

[in] Ein Zeiger auf Daten, die als Parameter für die durch den lpfButtonCallback-Parameter angegebene Funktion verwendet wurden.

lpszButtonText

[in] Ein Zeiger auf eine Zeichenfolge, die Text enthält, der auf die hinzugefügte Schaltfläche angewendet werden soll, wenn diese Schaltfläche erweiterbar ist. Der lpszButtonText-Parameter sollte NULL sein, wenn Sie keine erweiterbare Schaltfläche benötigen.

ulFlags

[in] Eine Bitmaske von Flags, die den Texttyp für den lpszButtonText-Parameter steuert. Die folgenden Flags können festgelegt werden:

AB_TELL_DETAILS_CHANGE

Gibt an, dass Details S_OK zurückgibt, wenn tatsächlich Änderungen an der Adresse vorgenommen werden; Andernfalls gibt Details S_FALSE zurück.

DIALOG_MODAL

Zeigt die modale Version des Dialogfelds "Allgemeine Adresse" an, das in Nicht-Outlook-Clients immer angezeigt wird. Dieses Flag schließt sich mit DIALOG_SDI gegenseitig aus.

DIALOG_SDI

Anzeigen der moduslosen Version des Dialogfelds "Allgemeine Adresse". Dieses Flag wird für Nicht-Outlook-Clients ignoriert.

MAPI_UNICODE

Die übergebenen Zeichenfolgen liegen im Unicode-Format vor. Wenn das MAPI_UNICODE-Flag nicht festgelegt ist, liegen die Zeichenfolgen im ANSI-Format vor.

Rückgabewert

S_OK

Das Detaildialogfeld wurde erfolgreich für den Adressbucheintrag angezeigt.

Hinweise

Clientanwendungen rufen die Details-Methode auf, um ein Dialogfeld anzuzeigen, das Details zu einem bestimmten Eintrag im Adressbuch enthält. Sie können die Parameter lpfButtonCallback, lpvButtonContext und lpszButtonText verwenden, um dem Dialogfeld eine clientdefinierte Schaltfläche hinzuzufügen. Wenn auf die Schaltfläche geklickt wird, ruft MAPI die Rückruffunktion auf, auf die lpfButtonCallback verweist, und übergibt sowohl den Eintragsbezeichner der Schaltfläche als auch die Daten in lpvButtonContext. Wenn Sie keine erweiterbare Schaltfläche benötigen, sollte lpszButtonText NULL sein.

Details unterstützen Unicode-Zeichenfolgen; Unicode-Zeichenfolgen werden in das MbCS-Format (Multibyte-Zeichenfolge) konvertiert, bevor sie im Detaildialogfeld angezeigt werden.

MFCMAPI-Referenz

Einen MFCMAP-Beispielcode finden Sie in der folgenden Tabelle.

Datei Funktion Kommentar
BaseDialog.cpp
CBaseDialog::OnOpenEntryID
MFCMAPI verwendet die Details-Methode , um ein Dialogfeld anzuzeigen, in dem die Details für einen Adressbucheintrag angezeigt werden.

Siehe auch

ADRPARM

IAddrBook::Address

LPFNBUTTON

IAddrBook : IMAPIProp

MFCMAPI (engl.) als ein Codebeispiel