IMsgStore::SetReceiveFolder
Gilt für: Outlook 2013 | Outlook 2016
Richtet einen Ordner als Ziel für eingehende Nachrichten einer bestimmten Nachrichtenklasse ein.
HRESULT SetReceiveFolder(
LPSTR lpszMessageClass,
ULONG ulFlags,
ULONG cbEntryID,
LPENTRYID lpEntryID
);
Parameter
lpszMessageClass
[in] Ein Zeiger auf die Nachrichtenklasse, die dem neuen Empfangsordner zugeordnet werden soll. Wenn der lpszMessageClass-Parameter auf NULL oder eine leere Zeichenfolge festgelegt ist, legt SetReceiveFolder den Standard-Empfangsordner für den Nachrichtenspeicher fest.
ulFlags
[in] Eine Bitmaske von Flags, die den Typ des Texts in den übergebenen Zeichenfolgen steuert. Das folgende Flag kann festgelegt werden:
MAPI_UNICODE
Die Nachrichtenklassenzeichenfolge weist das Unicode-Format auf. Wenn das MAPI_UNICODE-Flag nicht festgelegt ist, weist die Nachrichtenklassenzeichenfolge das ANSI-Format auf.
cbEntryID
[in] Die Byteanzahl im Eintragsbezeichner, auf die der lpEntryID-Parameter verweist.
lpEntryID
[in] Ein Zeiger auf den Eintragsbezeichner des Ordners, der als Empfangsordner festgelegt werden soll. Wenn der lpEntryID-Parameter auf NULL festgelegt ist, ersetzt SetReceiveFolder den aktuellen Empfangsordner durch den Standardwert des Nachrichtenspeichers.
Rückgabewert
S_OK
Ein Empfangsordner wurde erfolgreich eingerichtet.
Hinweise
Die IMsgStore::SetReceiveFolder-Methode legt den Empfangsordner für eine bestimmte Nachrichtenklasse fest oder ändert diese. Mit SetReceiveFolder kann ein Client mithilfe aufeinander folgender Aufrufe einen anderen Empfangsordner für jede definierte Nachrichtenklasse angeben oder angeben, dass eingehende Nachrichten für mehrere Nachrichtenklassen alle in denselben Ordner gelangen. Beispielsweise kann ein Client über eine eigene Klasse von Nachrichten verfügen, die in seinem eigenen Ordner eingehen. Eine Faxanwendung kann einen Ordner festlegen, in dem der Speicheranbieter eingehende Faxe ablegt, und einen anderen Ordner, in dem der Anbieter ausgehende Faxe ablegt.
Wenn während des Aufrufs von SetReceiveFolder ein Fehler auftritt, bleibt die Einstellung des Empfangsordners unverändert.
Wenn SetReceiveFolder die Einstellung des Empfangsordners ändert, wobei lpEntryID auf NULL festgelegt ist, was angibt, dass der Standardempfängerordner festgelegt werden soll, gibt SetReceiveFolder S_OK zurück, auch wenn keine Einstellung für die angegebene Nachrichtenklasse vorhanden war.
MFCMAPI-Referenz
Einen MFCMAP-Beispielcode finden Sie in der folgenden Tabelle.
| Datei | Funktion | Kommentar |
|---|---|---|
| MsgStoreDlg.cpp |
CMsgStoreDlg::OnSetReceiveFolder |
MFCMAPI verwendet die IMsgStore::SetReceiveFolder-Methode , um einen Ordner als Empfangsordner für eine bestimmte Nachrichtenklasse festzulegen. |