IMAPISupport::NewEntry
Gilt für: Outlook 2013 | Outlook 2016
Fügt einen neuen Empfänger direkt einem Adressbuchcontainer oder der Empfängerliste einer ausgehenden Nachricht 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 des Dialogfelds.
ulFlags
[in] Reserviert. NULL muss sein.
cbEIDContainer
[in] Die Byteanzahl im Eintragsbezeichner, auf die der lpEIDContainer-Parameter verweist.
lpEIDContainer
[in] Ein Zeiger auf den Eintragsbezeichner des Containers, der den neuen Eintrag empfangen soll. Wenn cbEIDContainer den Wert 0 hat und lpEIDContainer NULL ist, erstellt NewEntry einen einmaligen Eintragsbezeichner, der demselben Typ entspricht, der durch einen Aufruf der IMAPISupport::CreateOneOff-Methode generiert wird.
cbEIDNewEntryTpl
[in] Die Byteanzahl im Eintragsbezeichner, auf die der lpEIDNewEntryTpl-Parameter verweist.
lpEIDNewEntryTpl
[in] Ein Zeiger auf den Eintragsbezeichner der Vorlage, die zum Erstellen des neuen Eintrags verwendet werden soll. Wenn cbEIDNewEntryTpl den Wert 0 und lpEIDNewEntryTpl null ist, zeigt NewEntry ein Dialogfeld an, in dem der Benutzer aus einer Liste von Vorlagen auswählen kann, um neue Einträge hinzuzufügen.
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 neu erstellten Eintrags.
Rückgabewert
S_OK
Der neue Eintrag wurde erfolgreich erstellt.
Hinweise
Die IMAPISupport::NewEntry-Methode wird für Adressbuchanbieterunterstützungsobjekte implementiert. Adressbuchanbieter rufen NewEntry auf, um einen neuen Adressbucheintrag zu erstellen, 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 0 fest.
Wenn Sie dem Benutzer einer Clientanwendung erlauben möchten, den Typ des zu erstellenden Eintrags auszuwählen, übergeben Sie 0 in cbEIDNewEntryTpl und NULL in lpEIDNewEntryTpl. NewEntry zeigt die einmalige MAPI-Tabelle, eine Liste der Vorlagen an, die MAPI und die einzelnen Adressbuchanbieter in der Sitzung unterstützen. 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 IMAPISupport::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 IMAPISupport::NewEntry auf, und legen Sie den lpEIDNewEntryTpl-Parameter 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 0 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.