IAddrBook::Address

Artikel
04/04/2023

Gilt für: Outlook 2013 | Outlook 2016

Zeigt das Dialogfeld Outlook-Adressbuch an.

HRESULT Address(
  ULONG_PTR FAR * lpulUIParam,
  LPADRPARM lpAdrParms,
  LPADRLIST FAR * lppAdrList
);

Parameter

lpulUIParam

[in, out] Ein Zeiger auf ein Handle des übergeordneten Fensters des Dialogfelds. Bei der Eingabe muss immer ein Fensterhandle übergeben werden. Wenn der ulFlags-Member des lpAdrParms-Parameters auf DIALOG_SDI festgelegt ist, wird das Fensterhandle des dialogfelds ohne Modus zurückgegeben. Weitere Informationen finden Sie in der "Anmerkungen".

lpAdrParms

[in, out] Ein Zeiger auf eine ADRPARM-Struktur , die die Darstellung und das Verhalten des Adressdialogfelds steuert.

lppAdrList

[in, out] Ein Zeiger auf einen Zeiger auf eine ADRLIST-Struktur , die Empfängerinformationen enthält. Bei der Eingabe kann dieser Parameter NULL sein oder auf einen gültigen Zeiger zeigen. Bei der Ausgabe verweist dieser Parameter auf einen Zeiger auf gültige Empfängerinformationen.

Rückgabewert

S_OK

Das Dialogfeld "Allgemeine Adresse" wurde erfolgreich angezeigt.

Hinweise

Wenn das ulFlags-Element des lpAdrParms-Parameters auf DIALOG_SDI festgelegt ist, um die Rückgabe des Fensterhandles des dialogfelds ohne Modus bei der Ausgabe zu erwarten, wird es in Outlook ignoriert. Die modale Version des Dialogfelds wird in Nicht-Outlook-Clients immer angezeigt.

Die ADRLIST-Struktur , die von MAPI über den lppAdrList-Parameter an den Aufrufer zurückgegeben wird, enthält ein Array von ADRENTRY-Strukturen , eine Struktur für jeden Empfänger. Wenn sie im lpMods-Parameter an die IMessage::ModifyRecipients-Methode einer ausgehenden Nachricht übergeben wird, kann die ADRLIST-Struktur verwendet werden, um die Empfängerliste zu aktualisieren.

Jede ADRENTRY-Struktur in der ADRLIST-Struktur enthält null oder mehr SPropValue-Strukturen , eine Struktur für jeden Eigenschaftensatz für den Empfänger. Es kann keine SPropValue-Strukturen geben, wenn das von der Address-Methode angezeigte Dialogfeld verwendet wird, um einen Empfänger zu entfernen. Wenn eine oder mehrere SPropValue-Strukturen vorhanden sind, wird die entsprechende ADRENTRY-Struktur verwendet, um einen Empfänger hinzuzufügen oder zu aktualisieren. Der Empfänger kann aufgelöst werden, was angibt, dass eine der SPropValue-Strukturen die PR_ENTRYID (PidTagEntryId)-Eigenschaft des Empfängers beschreibt, oder nicht aufgelöst, was angibt, dass die PR_ENTRYID-Eigenschaft fehlt.

Zusätzlich zu PR_ENTRYID enthalten aufgelöste Empfänger die folgenden Eigenschaften:

PR_RECIPIENT_TYPE (PidTagRecipientType)
PR_DISPLAY_NAME (PidTagDisplayName)
PR_ADDRTYPE (PidTagAddressType)
PR_DISPLAY_TYPE (PidTagDisplayType)

Die vom Aufrufer übergebene ADRLIST-Struktur kann eine andere Größe aufweisen als die Struktur, die MAPI zurückgibt. Wenn MAPI eine größere ADRLIST-Struktur zurückgeben muss, gibt sie die ursprüngliche Struktur frei und ordnet eine neue zu. Wenn Sie Arbeitsspeicher für die ADRLIST-Struktur zuweisen, weisen Sie den Arbeitsspeicher für jede SPropValue-Struktur separat zu. Weitere Informationen zum Zuordnen und Freigeben von ADRLIST-Strukturen finden Sie unter Verwalten von Arbeitsspeicher für ADRLIST- und SRowSet-Strukturen.

Address gibt sofort zurück, wenn das DIALOG_SDI-Flag im ulFlags-Member der ADRPARM-Struktur im lpAdrParms-Parameter festgelegt ist. Das DIALOG_SDI-Flag wird für Nicht-Outlook-Clients ignoriert. Wenn DIALOG_SDI ignoriert wird, wird die modale Version des Dialogfelds angezeigt, und ein Zeiger auf ein Handle sollte in lpulUIParam nicht erwartet werden.

Address unterstützt Unicode-Zeichenfolgen in der ADRPARM-Struktur , wenn AB_UNICODEUI im ulFlags-Member von ADRPARM im lpAdrParms-Parameter angegeben wurde, und unicode-Zeichenfolgen in ADRLIST unterstützt werden. Die Unicode-Zeichenfolgen werden in das MbCS-Format (Multibyte-Zeichenfolge) konvertiert, bevor sie im Dialogfeld Outlook-Adressbuch angezeigt werden.

MFCMAPI-Referenz

Einen MFCMAP-Beispielcode finden Sie in der folgenden Tabelle.

Datei	Funktion	Kommentar
MAPIStoreFunctions.cpp	OpenOtherUsersMailboxFromGal	MFCMAPI verwendet die Address-Methode , damit der Benutzer auswählen kann, welches Postfach geöffnet werden soll.