IMsgStore::SetLockState
S’applique à : Outlook 2013 | Outlook 2016
Verrouille ou déverrouille un message. Cette m�thode est appel�e uniquement par le spouleur MAPI.
HRESULT SetLockState(
LPMESSAGE lpMessage,
ULONG ulLockState
);
Paramètres
lpMessage
[in] Pointeur vers le message à verrouiller ou à déverrouiller.
ulLockState
[in] Valeur qui indique si le message doit être verrouillé ou déverrouillé. L’une des valeurs suivantes est valide :
MSG_LOCKED
Le message doit être verrouillé.
MSG_UNLOCKED
Le message doit être déverrouillé.
Valeur renvoyée
S_OK
L’état de verrouillage du message a été correctement défini.
Remarques
La méthode IMsgStore ::SetLockState verrouille ou déverrouille un message. SetLockState peut être appelé uniquement par le spouleur MAPI lors de l’envoi du message.
En règle générale, lorsque le spouleur MAPI appelle SetLockState pour verrouiller un message, il verrouille uniquement le message le plus ancien (autrement dit, le message suivant mis en file d’attente pour que le spouleur MAPI envoie). Si le message le plus ancien de la file d’attente attend un fournisseur de transport temporairement indisponible et que le message suivant dans la file d’attente utilise un autre fournisseur de transport, le spouleur MAPI peut commencer à traiter le message suivant. Il commence le traitement en verrouillant ce message à l’aide de SetLockState.
Remarques pour les responsables de l’implémentation
Une fois que le spouleur MAPI a appelé SetLockState avec le paramètre ulLockState défini sur MSG_LOCKED, les appels à la méthode IMsgStore ::AbortSubmit pour annuler la transmission du message doivent échouer.
Appelez la méthode IMAPIProp ::SaveChanges du message dans votre implémentation SetLockState afin que toutes les modifications apportées au message avant la réception de l’appel SetLockState soient enregistrées.