Partager via

IMAPIOffline::SetCurrentState

  • Article

S’applique à : Outlook 2013 | Outlook 2016

Définit l’état actuel d’un objet hors connexion sur en ligne ou hors connexion.

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

Paramètres

ulFlags

[in] Modifie le comportement de cet appel. Les valeurs prises en charge sont les suivantes :

MAPIOFFLINE_FLAG_BLOCK

La définition de ulFlags sur cette valeur bloque l’appel SetCurrentState jusqu’à ce que le changement d’état soit terminé. Par défaut, la transition a lieu de manière asynchrone. Lorsque la transition se produit de manière asynchrone, tous les appels SetCurrentState retournent E_PENDING jusqu’à ce que la modification soit terminée.

MAPIOFFLINE_FLAG_DEFAULT

Définit l’état actuel sans blocage.

ulMask

[in] Partie de l’état à modifier. La seule valeur prise en charge est MAPIOFFLINE_STATE_OFFLINE_MASK.

ulState

[in] État à modifier. Il doit s’agir de l’une des deux valeurs suivantes :

MAPIOFFLINE_STATE_ONLINE

MAPIOFFLINE_STATE_OFFLINE

Conservés

Ce paramètre est réservé à un usage interne Outlook et n’est pas pris en charge.

Valeur renvoyée

S_OK

L’état de l’objet hors connexion a été modifié avec succès.

E_PENDING

Cela indique que l’état de l’objet hors connexion change de façon asynchrone. Cela se produit lorsque ulFlags est défini sur MAPIOFFLINE_FLAG_BLOCK dans un appel SetCurrentState antérieur, et tout appel SetCurrentState suivant retourne cette valeur jusqu’à ce que le changement d’état asynchrone soit terminé.

Voir aussi

IMAPIOffline::GetCapabilities
IMAPIOffline ::GetCurrentState, constantes MAPI