Freigeben über

IMAPIOffline::SetCurrentState

  • Artikel

Gilt für: Outlook 2013 | Outlook 2016

Legt den aktuellen Status eines Offlineobjekts auf Online oder Offline fest.

HRESULT SetCurrentState( 
    ULONG ulFlags, 
    ULONG ulMask, 
    ULONG ulState, 
    void* pReserved 
);

Parameter

ulFlags

[in] Ändert das Verhalten dieses Aufrufs. Die folgenden Werte werden unterstützt:

MAPIOFFLINE_FLAG_BLOCK

Wenn Sie ulFlags auf diesen Wert festlegen, wird der SetCurrentState-Aufruf blockiert, bis die Zustandsänderung abgeschlossen ist. Standardmäßig erfolgt der Übergang asynchron. Wenn der Übergang asynchron erfolgt, geben alle SetCurrentState-AufrufeE_PENDING zurück, bis die Änderung abgeschlossen ist.

MAPIOFFLINE_FLAG_DEFAULT

Legt den aktuellen Zustand ohne Blockierung fest.

ulMask

[in] Der zu ändernde Teil des Zustands. Der einzige unterstützte Wert ist MAPIOFFLINE_STATE_OFFLINE_MASK.

ulState

[in] Der Zustand, in den geändert werden soll. Es muss einer der beiden folgenden Werte sein:

MAPIOFFLINE_STATE_ONLINE

MAPIOFFLINE_STATE_OFFLINE

Erhalten

Dieser Parameter ist für die interne Verwendung von Outlook reserviert und wird nicht unterstützt.

Rückgabewert

S_OK

Der Status des Offlineobjekts wurde erfolgreich geändert.

E_PENDING

Dies gibt an, dass sich der Zustand des Offlineobjekts asynchron ändert. Dies tritt auf, wenn ulFlags in einem früheren SetCurrentState-Aufruf auf MAPIOFFLINE_FLAG_BLOCK festgelegt ist und jeder nachfolgende SetCurrentState-Aufruf diesen Wert zurückgibt, bis die asynchrone Zustandsänderung abgeschlossen ist.

Siehe auch

IMAPIOffline::GetCapabilities
IMAPIOffline::GetCurrentStateMAPI-Konstanten