ICancelMethodCalls ::Cancel, méthode (objidl.h)
Demande qu’un appel de méthode soit annulé.
Syntaxe
HRESULT Cancel(
[in] ULONG ulSeconds
);
Paramètres
[in] ulSeconds
Nombre de secondes à attendre que le serveur termine l’appel sortant après que le client a demandé l’annulation.
Valeur retournée
Cette méthode peut retourner l’une de ces valeurs.
| Code de retour | Description |
|---|---|
|
La demande d’annulation a été effectuée. |
|
L’appel a déjà été annulé. |
|
L’annulation d’appel n’est pas activée sur le thread qui traite l’appel. |
|
L’appel a été effectué pendant l’intervalle de délai d’expiration. |
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 | objidl.h (inclure ObjIdl.h) |