IMAPIMessageSite::GetSiteStatus
Gilt für: Outlook 2013 | Outlook 2016
Gibt Informationen aus einem Nachrichtenwebsiteobjekt zu den Funktionen der Nachrichtenwebsite für die aktuelle Nachricht zurück.
HRESULT GetSiteStatus(
ULONG FAR * lpulStatus
);
Parameter
lpulStatus
[out] Ein Zeiger auf eine Bitmaske von Flags, die Informationen zu Nachrichten status 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
Wenn eine Nachricht gelöscht wird, wird sie in den Ordner Gelöschte Elemente im zugehörigen 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 IMAPIMessageSite::GetSiteStatus-Methode auf, um die Funktionen des Nachrichtenwebsiteobjekts für die aktuelle Nachricht abzurufen. Die im lpulStatus-Parameter zurückgegebenen Flags enthalten Informationen zur Nachrichtenwebsite. In der Regel aktiviert oder deaktiviert ein Formular Menübefehle, je nachdem, welche Informationen die Flags über die Funktionen der Nachrichtenwebsiteimplementierung bereitstellen. Wenn eine neue Nachricht von der IPersistMessage::SaveCompleted-Methode oder der IPersistMessage::Load-Methode in ein Formular geladen wird, müssen die status-Flags überprüft werden. Einige Nachrichtenwebsiteobjekte, insbesondere schreibgeschützte Objekte, lassen das Speichern oder Löschen von Nachrichten nicht zu.
Hinweise für Implementierer
Die IMAPIMessageSite::GetSiteStatus-Methode erfordert möglicherweise, dass die Clientanwendung eine Berechnung durchführt, um zu bestimmen, welche Vorgänge für die aktuelle Nachricht ausgeführt werden können oder nicht. In der Regel umfasst dies das Betrachten der status Zeile für den Nachrichtenspeicheranbieter der aktuellen Nachricht oder das Abfragen des Speicheranbieters, um zu bestimmen, welche Aktionen die Clientanwendung mithilfe des Nachrichtenspeichers ausführen kann. Um beispielsweise zu bestimmen, ob das MAPI_DELETE_IS_MOVE-Flag zurückgegeben werden soll, überprüfen Sie die PR_IPM_WASTEBASKET_ENTRYID-Eigenschaft (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 IMAPIMessageSite::GetSiteStatus-Methode, um die status der angegebenen Website abzurufen. Es kann VCSTATUS_NEW_MESSAGE, VCSTATUS_SAVE oder VCSTATUS_SUBMIT zurückgeben. |
Siehe auch
IPersistMessage::SaveCompleted
PidTagIpmWastebasketEntryId (kanonische Eigenschaft)