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 des appels 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 d’annulation est disponible. Pour activer l’annulation des appels, vous devez d’abord appeler CoEnableCallCancellation .

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

Un appel est annulable ou ne dépend pas 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 des appels n’a aucun effet sur les appels en attente sur le thread.

Spécifications

Voir aussi

CoEnableCallCancellation

ICancelMethodCalls