ICancelMethodCalls ::Cancel, méthode (objidlbase.h)

  • Article

Demande qu’un appel de méthode soit annulé.

Syntaxe

HRESULT Cancel(
  [in] ULONG ulSeconds
);

Paramètres

[in] ulSeconds

Nombre de secondes à attendre avant que le serveur termine l’appel sortant après l’annulation de la demande du client.

Valeur retournée

Cette méthode peut retourner l’une de ces valeurs.

Code de retour Description
S_OK
 La demande d’annulation a été effectuée.
RPC_S_CALL_CANCELED
 L’appel a déjà été annulé.
CO_E_CANCEL_DISABLED
 L’annulation d’appel n’est pas activée sur le thread qui traite l’appel.
RPC_E_CALL_COMPLETE
 L’appel a été terminé pendant l’intervalle de délai d’attente.

Remarques

La méthode Cancel émet uniquement une demande d’annulation. Une valeur de retour de S_OK ne signifie pas que l’appel a été annulé, mais seulement qu’une tentative d’annulation de l’appel a été effectuée. Le comportement de l’objet cancel lors de la réception d’une demande d’annulation est entièrement à la discrétion de l’implémenteur.

Si une méthode qui retourne un HRESULT est annulée, la valeur de retour est RPC_S_CALL_CANCELED.

Configuration requise

Condition requise Valeur
Client minimal pris en charge Windows 2000 Professionnel [applications de bureau uniquement]
Serveur minimal pris en charge Windows 2000 Server [applications de bureau uniquement]
Plateforme cible Windows
En-tête objidlbase.h (inclure ObjIdl.h)

Voir aussi

ICancelMethodCalls