IMAPISupport::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 Anzeigenamen des Empfängers der eigenschaft PR_DISPLAY_NAME (PidTagDisplayName). Der lpszName-Parameter kann NULL sein.
lpszAdrType
[in] Ein Zeiger auf den Adresstyp (z. B. FAX, SMTP oder X500) des Empfängers. Der lpszAdrType-Parameter darf nicht NULL sein.
lpszAddress
[in] Ein Zeiger auf die Messagingadresse 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 Anzahl der Bytes im Eintragsbezeichner, auf die 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
Die IMAPISupport::CreateOneOff-Methode wird für alle Dienstanbieterunterstützungsobjekte implementiert. Dienstanbieter rufen CreateOneOff auf, um einen Eintragsbezeichner für einen einmaligen Empfänger zu erstellen (ein Empfänger, der zu keinem der Container von einem der aktuell geladenen Adressbuchanbieter gehört).
Hinweise für Aufrufer
Wenn Sie die Verwendung des von CreateOneOff zurückgegebenen Eintragsbezeichners abgeschlossen haben, geben Sie den für den Eintragsbezeichner zugewiesenen Arbeitsspeicher mithilfe der MAPIFreeBuffer-Funktion frei.
Hinweise zu Transportanbietern
Unterstützen Sie das Transport Neutral Encapsulation Format (TNEF), und verwenden Sie den Wert der PR_SEND_RICH_INFO-Eigenschaft , um zu bestimmen, ob TNEF beim Transport einer Nachricht verwendet werden soll. TNEF wird nicht unterstützt oder keine Nachricht in diesem Format gesendet, wenn sie angefordert wird, kann ein Problem für formularbasierte Clients oder Clients sein, die benutzerdefinierte MAPI-Eigenschaften erfordern. Dies liegt daran, dass TNEF in der Regel verwendet wird, um benutzerdefinierte Eigenschaften für benutzerdefinierte Nachrichtenklassen zu senden.
Siehe auch
PidTagDisplayName (kanonische Eigenschaft)