IMAPISession::SetDefaultStore
Gilt für: Outlook 2013 | Outlook 2016
Richtet einen Nachrichtenspeicher als Standardnachrichtenspeicher für die Sitzung ein.
HRESULT SetDefaultStore(
ULONG ulFlags,
ULONG cbEntryID,
LPENTRYID lpEntryID
);
Parameter
ulFlags
[in] Eine Bitmaske von Flags, die die Einstellung des Standardnachrichtenspeichers steuert. Diese Flags schließen sich gegenseitig aus. Es kann nur eines der folgenden Flags festgelegt werden:
MAPI_DEFAULT_STORE
Richtet den Nachrichtenspeicher als Sitzungsstandard ein. Updates die status Tabellenzeile des Nachrichtenspeichers, indem Sie das STATUS_DEFAULT_STORE-Flag in der Spalte PR_RESOURCE_FLAGS (PidTagResourceFlags) festlegen.
MAPI_PRIMARY_STORE
Richtet den Nachrichtenspeicher als Speicher ein, der bei der Anmeldung verwendet werden soll. Wenn der Nachrichtenspeicher nicht der Standardspeicher ist, sollten Clients ihn zur Standardeinstellung machen. Updates die status Tabellenzeile des Nachrichtenspeichers, indem Sie das flag STATUS_PRIMARY_STORE in der spalte PR_RESOURCE_FLAGS festlegen.
MAPI_SECONDARY_STORE
Richtet den Nachrichtenspeicher als Speicher ein, der bei der Anmeldung verwendet werden soll, wenn der primäre Nachrichtenspeicher nicht verfügbar ist. Wenn ein Client den primären Speicher nicht öffnen kann, sollte er den sekundären Speicher öffnen und als Standard festlegen. Updates der status Tabellenzeile des Nachrichtenspeichers, indem Sie das STATUS_SECONDARY_STORE-Flag in der spalte PR_RESOURCE_FLAGS festlegen.
MAPI_SIMPLE_STORE_PERMANENT
Legt das STATUS_SIMPLE_STORE-Flag in der PR_RESOURCE_FLAGS-Eigenschaft des Nachrichtenspeichers in der status Tabellenzeile, der Nachrichtenspeichertabellenzeile und im Sitzungsprofil fest.
MAPI_SIMPLE_STORE_TEMPORARY
Legt das STATUS_SIMPLE_STORE-Flag in der PR_RESOURCE_FLAGS-Eigenschaft des Nachrichtenspeichers in der status Tabellenzeile und der Nachrichtenspeichertabellenzeile fest. Das Profil wird nicht geändert.
cbEntryID
[in] Die Byteanzahl im Eintragsbezeichner, auf die der lpEntryID-Parameter verweist.
lpEntryID
[in] Ein Zeiger auf den Eintragsbezeichner des Nachrichtenspeichers, der als Standard vorgesehen ist. Wenn ein Client NULL in lpEntryID übergibt, wird kein Nachrichtenspeicher als Standard ausgewählt.
Rückgabewert
S_OK
Der Aufruf war erfolgreich und hat den erwarteten Wert oder die erwarteten Werte zurückgegeben.
Hinweise
Die IMAPISession::SetDefaultStore-Methode richtet einen Nachrichtenspeicher wie folgt ein:
Der Standardnachrichtenspeicher für die Sitzung.
Der primäre Nachrichtenspeicher für die Sitzung.
Der sekundäre Nachrichtenspeicher für die Sitzung.
Um einen Nachrichtenspeicher als Standard festzulegen, müssen für den Nachrichtenspeicher die folgenden Flags in seiner PR_STORE_SUPPORT_MASK -Eigenschaft (PidTagStoreSupportMask) festgelegt sein:
STORE_SUBMIT_OK
STORE_CREATE_OK
STORE_MODIFY_OK
Hinweise für Aufrufer
Sie können den Standardnachrichtenspeicher für die Sitzung ermitteln, indem Sie die status Tabelle abrufen und in der spalte PR_RESOURCE_FLAGS nach der Einstellung des flags STATUS_DEFAULT_STORE suchen. Die Zeile mit dieser Einstellung stellt den Nachrichtenspeicher dar, der als Sitzungsstandard festgelegt ist.
Wenn entweder das MAPI_DEFAULT_STORE- oder das MAPI_SIMPLE_STORE_PERMANENT-Flag festgelegt ist, aktualisiert MAPI das Profil, die Nachrichtenspeichertabelle und status Tabelle.
Wenn eine Änderung an der Standardeinstellung des Nachrichtenspeichers vorgenommen wird, werden die folgenden Benachrichtigungen generiert:
Für jede betroffene Zeile im Nachrichtenspeicher und status Tabelle wird eine fnevTableModified-Ereignisbenachrichtigung ausgegeben.
Für den MAPI-Spooler wird eine interne Benachrichtigung ausgegeben. Bereits laufende Vorgänge werden ohne Änderungen abgeschlossen; Neue Vorgänge, die den Standardnachrichtenspeicher betreffen, z. B. das Herunterladen von Nachrichten, werden für den neuen Standardspeicher verarbeitet.
MFCMAPI-Referenz
Einen MFCMAP-Beispielcode finden Sie in der folgenden Tabelle.
| Datei | Funktion | Kommentar |
|---|---|---|
| MainDlg.cpp |
CMainDlg::OnSetDefaultStore |
MFCMAPI verwendet die IMAPISession::SetDefaultStore-Methode , um den ausgewählten Speicher als Standardspeicher festzulegen. |
Siehe auch
PidTagResourceFlags (kanonische Eigenschaft)