CoEnableCallCancellation, fonction (combaseapi.h)

Active l’annulation des appels synchrones sur le thread appelant.

Syntaxe

HRESULT CoEnableCallCancellation(
  [in, optional] LPVOID pReserved
);

Paramètres

[in, optional] pReserved

Ce paramètre est réservé et doit être NULL.

Valeur retournée

Cette fonction peut retourner les valeurs de retour standard S_OK, E_FAIL, E_INVALIDARG et E_OUTOFMEMORY.

Remarques

Lorsque l’annulation d’appel est activée sur un thread, les appels synchrones marshalés de ce thread vers des objets sur le même ordinateur peuvent subir une dégradation grave des performances. Par défaut, les appels synchrones ne peuvent pas être annulés, même si un objet cancel est disponible. Pour activer l’annulation d’appel, vous devez d’abord appeler CoEnableCallCancellation .

À moins que vous ne souhaitiez activer l’annulation d’appel sur un thread à tout moment, vous devez associer les appels à CoEnableCallCancellation avec les appels à CoDisableCallCancellation. L’annulation d’appel est désactivée uniquement si CoDisableCallCancellation a été appelé une fois pour chaque fois que CoEnableCallCancellation a été appelé avec succès.

Un appel peut être annulé ou non en fonction de l’état du thread au moment où l’appel a été effectué. Par la suite, l’activation ou la désactivation de l’annulation d’appel n’a aucun effet sur les appels en attente sur le thread.

Configuration requise

Voir aussi

CoEnableCallCancellation

ICancelMethodCalls