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. |