IAddrBook::NewEntry
Gilt für: Outlook 2013 | Outlook 2016
Fügt einem Adressbuchcontainer oder der Empfängerliste einer ausgehenden Nachricht einen neuen Empfänger hinzu.
HRESULT NewEntry(
ULONG_PTR ulUIParam,
ULONG ulFlags,
ULONG cbEIDContainer,
LPENTRYID lpEIDContainer,
ULONG cbEIDNewEntryTpl,
LPENTRYID lpEIDNewEntryTpl,
ULONG FAR * lpcbEIDNewEntry,
LPENTRYID FAR * lppEIDNewEntry
);
Parameter
ulUIParam
[in] Ein Handle für das übergeordnete Fenster für das Dialogfeld.
ulFlags
[in] Eine Bitmaske von Flags, die den Typ des verwendeten Texts steuert. Das folgende Flag kann festgelegt werden:
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.
cbEIDContainer
[in] Die Byteanzahl im Eintragsbezeichner, auf die der lpEIDContainer-Parameter verweist.
lpEIDContainer
[in] Ein Zeiger auf den Eintragsbezeichner des Containers, dem der neue Empfänger hinzugefügt werden soll. Wenn der cbEIDContainer-Parameter null ist, gibt die NewEntry-Methode einen Empfängereintragsbezeichner und eine Liste von Vorlagen zurück, als ob die IAddrBook::CreateOneOff-Methode aufgerufen würde.
cbEIDNewEntryTpl
[in] Die Byteanzahl im Eintragsbezeichner, auf die der lpEIDNewEntryTpl-Parameter verweist.
lpEIDNewEntryTpl
[in] Ein Zeiger auf eine einmalige Vorlage, die zum Erstellen des neuen Empfängers verwendet wird. Wenn cbEIDNewEntryTpl null und lpEIDNewEntryTpl null ist, zeigt NewEntry ein Dialogfeld an, mit dem der Benutzer aus einer Liste von Vorlagen zum Hinzufügen neuer Einträge auswählen kann.
lpcbEIDNewEntry
[out] Ein Zeiger auf die Byteanzahl im Eintragsbezeichner, auf den der lppEIDNewEntry-Parameter verweist.
lppEIDNewEntry
[out] Ein Zeiger auf einen Zeiger auf den Eintragsbezeichner des neuen Empfängers.
Rückgabewert
S_OK
Der neue Adressbucheintrag wurde erfolgreich erstellt.
Hinweise
Die NewEntry-Methode erstellt einen neuen Adressbucheintrag, der direkt zu einem Container hinzugefügt oder zum Adressieren einer ausgehenden Nachricht verwendet werden soll.
Hinweise für Aufrufer
Wenn der neue Eintrag einem bestimmten Container hinzugefügt werden soll, legen Sie lpEIDContainer auf den Eintragsbezeichner des Containers und cbEIDContainer auf die Byteanzahl im Eintragsbezeichner fest.
Wenn der neue Eintrag der Empfängerliste einer ausgehenden Nachricht hinzugefügt werden soll, legen Sie lpEIDContainer auf NULL und cbEIDContainer auf Null fest.
Wenn Sie dem Benutzer einer Clientanwendung erlauben möchten, den Typ des zu erstellenden Eintrags auszuwählen, übergeben Sie null in cbEIDNewEntryTpl und NULL in lpEIDNewEntryTpl. Die NewEntry-Methode zeigt die einmalige MAPI-Tabelle sowie eine Liste der Vorlagen an, die von MAPI und von jedem Adressbuchanbieter in der Sitzung unterstützt werden. Jede Vorlage kann einen Empfängereintrag für einen oder mehrere Adresstypen erstellen.
Wenn Sie den Eintragsbezeichner des neuen Eintrags beibehalten möchten, übergeben Sie gültige Zeiger in den Parametern lpcbEIDNewEntry und lppEIDNewEntry . Sie sind dafür verantwortlich, diesen Eintragsbezeichner frei zu geben, wenn Sie damit fertig sind, indem Sie die MAPIFreeBuffer-Funktion aufrufen.
Um eine bestimmte Vorlage zum Hinzufügen eines neuen Eintrags zu einem änderbaren Container zu verwenden, gehen Sie wie folgt vor:
Rufen Sie die IMAPISession::OpenEntry-Methode auf, um den Zielcontainer zu öffnen, und legen Sie den lpEntryID-Parameter auf den Eintragsbezeichner des Containers fest.
Rufen Sie die IMAPIProp::OpenProperty-Methode des Zielcontainers auf, und legen Sie den ulPropTag-Parameter auf PR_CREATE_TEMPLATES (PidTagCreateTemplates) und den lpiid-Parameter auf IID_IMAPITable fest. Der Container gibt eine einmalige Tabelle zurück, die alle Vorlagen auflistet, die er zum Erstellen neuer Einträge unterstützt.
Rufen Sie die Zeile ab, die die Vorlage für den bestimmten Eintragstyp darstellt, den Sie erstellen möchten. Die Spalte PR_ADDRTYPE (PidTagAddressType) gibt den Adresstyp an, der von der Vorlage unterstützt wird.
Rufen Sie die NewEntry-Methode auf, und legen Sie lpEIDNewEntryTpl auf den Eintragsbezeichner der ausgewählten Vorlage fest. Der Eintragsbezeichner ist die spalte PR_ENTRYID (PidTagEntryId) aus der Zeile der Vorlage in der einmaligen Tabelle. Übergeben Sie null in cbEIDContainer und NULL in lpEIDContainer. Übergeben Sie einen gültigen Zeiger im Parameter lppEIDNewEntry , wenn Sie den Eintragsbezeichner des neuen Eintrags beibehalten möchten.