Hinweis
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, sich anzumelden oder das Verzeichnis zu wechseln.
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, das Verzeichnis zu wechseln.
Gilt für: Outlook 2013 | Outlook 2016
Gibt Informationen von einem Nachrichtensiteobjekt über die Funktionen der Nachrichtensite für die aktuelle Nachricht zurück.
HRESULT GetSiteStatus(
ULONG FAR * lpulStatus
);
Parameter
lpulStatus
[out] Ein Zeiger auf eine Bitmaske von Flags, die Informationen zum Nachrichtenstatus bereitstellt. Die folgenden Flags können festgelegt werden:
VCSTATUS_COPY
Die Nachricht kann kopiert werden.
VCSTATUS_DELETE
Die Nachricht kann gelöscht werden.
VCSTATUS_DELETE_IS_MOVE
Beim Löschen wird eine Nachricht in einen Ordner Gelöschte Elemente im Nachrichtenspeicher verschoben, anstatt sofort aus dem Nachrichtenspeicher entfernt zu werden.
VCSTATUS_MOVE
Die Nachricht kann verschoben werden.
VCSTATUS_NEW_MESSAGE
Eine neue Nachricht kann erstellt werden.
VCSTATUS_SAVE
Die Nachricht kann gespeichert werden.
VCSTATUS_SUBMIT
Die Nachricht kann übermittelt werden.
Rückgabewert
S_OK
Der Aufruf erfolgreich ausgeführt und der erwartete Wert oder Werte zurückgegeben hat.
Hinweise
Formularobjekte rufen die Methode IMAPIMessageSite::GetSiteStatus auf, um die Funktionen des Nachrichtensiteobjekts für die aktuelle Nachricht abzurufen. Die im Parameter lpulStatus zurückgegebenen Flags stellen Informationen zur Nachrichtenwebsite bereit. In der Regel aktiviert oder deaktiviert ein Formular Menübefehle, abhängig von den Informationen, die die Flags über die Funktionen der Nachrichtensiteimplementierung bereitstellen. Wenn eine neue Nachricht von der IPersistMessage::SaveCompleted-Methode oder der IPersistMessage::Load-Methode in ein Formular geladen wird, müssen die Statusflags überprüft werden. Einige Nachrichtenwebsiteobjekte, insbesondere schreibgeschützte Objekte, lassen das Speichern oder Löschen von Nachrichten nicht zu.
Hinweise für Implementierer
Für die Methode IMAPIMessageSite::GetSiteStatus- muss die Clientanwendung möglicherweise eine Berechnung durchführen, um zu bestimmen, welche Vorgänge für die aktuelle Nachricht ausgeführt werden können oder nicht. Normalerweise muss dazu die Statuszeile für den Nachrichtenspeicheranbieter der aktuellen Nachricht angezeigt oder der Speicheranbieter abgefragt werden, um zu ermitteln, welche Aktionen die Clientanwendung mithilfe des Nachrichtenspeichers ausführen kann. Um beispielsweise zu bestimmen, ob das Flag MAPI_DELETE_IS_MOVE zurückgegeben werden soll, überprüfen Sie die Eigenschaft PR_IPM_WASTEBASKET_ENTRYID (PidTagIpmWastebasketEntryId) des Nachrichtenspeicherobjekts, um festzustellen, ob im Nachrichtenspeicher ein Ordner Gelöschte Elemente vorhanden ist.
Eine Liste der Schnittstellen im Zusammenhang mit Formularservern finden Sie unter MAPI-Formularschnittstellen.
MFCMAPI-Referenz
Einen MFCMAP-Beispielcode finden Sie in der folgenden Tabelle.
| Datei | Funktion | Kommentar |
|---|---|---|
| MyMAPIFormViewer.cpp |
CMyMAPIFormViewer::GetSiteStatus |
MFCMAPI verwendet die Methode IMAPIMessageSite::GetSiteStatus, um den Status der angegebenen Website abzurufen. Sie kann VCSTATUS_NEW_MESSAGE, VCSTATUS_SAVE oder VCSTATUS_SUBMIT zurückgeben. |
Siehe auch
IPersistMessage::SaveCompleted
Canonical Eigenschaft PidTagIpmWastebasketEntryId