IAddrBook::CreateOneOff
Gilt für: Outlook 2013 | Outlook 2016
Erstellt einen Eintragsbezeichner für eine einmalige Adresse.
HRESULT CreateOneOff(
LPSTR lpszName,
LPSTR lpszAdrType,
LPSTR lpszAddress,
ULONG ulFlags,
ULONG FAR * lpcbEntryID,
LPENTRYID FAR * lppEntryID
);
Parameter
lpszName
[in] Ein Zeiger auf den Wert der PR_DISPLAY_NAME (PidTagDisplayName)-Eigenschaft des Empfängers. Der lpszName-Parameter kann NULL sein.
lpszAdrType
[in] Ein Zeiger auf den Adresstyp des Empfängers, z. B. FAX oder SMTP. Der lpszAdrType-Parameter darf nicht NULL sein.
lpszAddress
[in] Ein Zeiger auf die Adresse des Empfängers. Der lpszAddress-Parameter darf nicht NULL sein.
ulFlags
[in] Eine Bitmaske von Flags, die sich auf den einmaligen Empfänger auswirkt. Die folgenden Flags können festgelegt werden:
MAPI_SEND_NO_RICH_INFO
Der Empfänger kann formatierten Nachrichteninhalt nicht verarbeiten. Wenn MAPI_SEND_NO_RICH_INFO festgelegt ist, legt MAPI die eigenschaft PR_SEND_RICH_INFO (PidTagSendRichInfo) des Empfängers auf FALSE fest. Wenn MAPI_SEND_NO_RICH_INFO nicht festgelegt ist, legt MAPI diese Eigenschaft auf TRUE fest, es sei denn, die Nachrichtenadresse des Empfängers, auf die von lpszAddress verwiesen wird, wird als Internetadresse interpretiert. In diesem Fall legt MAPI PR_SEND_RICH_INFO auf FALSE fest.
MAPI_UNICODE
Anzeigename, Adresstyp und Adresse liegen im Unicode-Format vor. Wenn das MAPI_UNICODE-Flag nicht festgelegt ist, liegen diese Zeichenfolgen im ANSI-Format vor.
lpcbEntryID
[out] Ein Zeiger auf die Byteanzahl im Eintragsbezeichner, auf den der lppEntryID-Parameter verweist.
lppEntryID
[out] Ein Zeiger auf einen Zeiger auf den Eintragsbezeichner für den einmaligen Empfänger.
Rückgabewert
S_OK
Der einmalige Eintragsbezeichner wurde erfolgreich erstellt.
Hinweise
Clients rufen die CreateOneOff-Methode auf, um einen Eintragsbezeichner für einen einmaligen Empfänger zu erstellen – einen Empfänger, der zu keinem der Container von einem der aktuell geladenen Adressbuchanbieter gehört. Einmalige Empfänger können über jede Art von Adresse verfügen, die von einem der aktiven Adressbuchanbieter für die Sitzung unterstützt wird.
Einmalige Empfänger werden in der Regel mit einer Vorlage für ihren bestimmten Adresstyp erstellt. Der Adressbuchanbieter, der den Adresstyp unterstützt, stellt die Vorlage bereit. Ein Benutzer einer Clientanwendung gibt die relevanten Informationen in die Vorlage ein.
MAPI unterstützt Unicode-Zeichenfolgen für den Anzeigenamen, den Adresstyp und die Adressparameter von CreateOneOff.
Das MAPI_SEND_NO_RICH_INFO-Flag steuert, ob formatierter Text im RICH-Text-Format (RTF) zusammen mit jeder Nachricht gesendet wird. Das Transport Neutral Encapsulation Format (TNEF) – ein Format, das zum Übertragen von formatiertem Text verwendet wird – wird von den meisten Transportanbietern gesendet, unabhängig davon, wie der Empfänger seine PR_SEND_RICH_INFO Eigenschaft festlegt. Dies ist kein Problem für Messagingclients, die mit zwischenmenschlichen Nachrichten arbeiten. Da TNEF jedoch in der Regel zum Senden benutzerdefinierter Eigenschaften für benutzerdefinierte Nachrichtenklassen verwendet wird, kann die Nichtunterstützung für formularbasierte Clients oder Clients, die benutzerdefinierte MAPI-Eigenschaften erfordern, ein Problem darstellen. Weitere Informationen finden Sie unter Senden von Nachrichten mit TNEF.
MFCMAPI-Referenz
Einen MFCMAP-Beispielcode finden Sie in der folgenden Tabelle.
| Datei | Funktion | Kommentar |
|---|---|---|
| Mapiabfunctions.cpp |
AddOneOffAddress |
MFCMAPI verwendet die CreateOneOff-Methode , um eine Eintrags-ID für eine Adresse zu erstellen, die in keinem Adressbuch gefunden wird. |