Remarque
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de vous connecter ou de modifier des répertoires.
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de modifier des répertoires.
Demande l’annulation d’un appel de méthode DCOM sortant en attente sur un thread spécifié.
Syntaxe
HRESULT CoCancelCall(
[in] DWORD dwThreadId,
[in] ULONG ulTimeout
);
Paramètres
[in] dwThreadId
Identificateur du thread sur lequel l’appel DCOM en attente doit être annulé. Si ce paramètre est 0, l’appel se trouve sur le thread actif.
[in] ulTimeout
Nombre de secondes que CoCancelCall attend que le serveur termine l’appel sortant après l’annulation du client.
Valeur retournée
Cette fonction peut retourner les valeurs de retour standard E_FAIL, E_OUTOFMEMORY et E_UNEXPECTED, ainsi que les valeurs suivantes.
| Code de retour | Description |
|---|---|
|
La demande d’annulation a été effectuée. |
|
Il n’existe aucun objet cancel correspondant au thread spécifié. |
|
L’annulation d’appel n’est pas activée sur le thread spécifié. |
|
L’appel a été terminé pendant l’intervalle de délai d’attente. |
|
L’appel a déjà été annulé. |
Remarques
CoCancelCall appelle CoGetCancelObject , puis ICancelMethodCalls::Cancel sur l’objet cancel pour l’appel en cours d’exécution.
Cette fonction ne localise pas les objets d’annulation pour les appels asynchrones.
Le serveur d’objets peut déterminer si l’appel a été annulé en appelant régulièrement CoTestCancel. Si l’appel a été annulé, le serveur d’objets doit propre et retourner le contrôle au client.
Configuration requise
| 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 | combaseapi.h (inclure Objbase.h) |
| Bibliothèque | Ole32.lib |
| DLL | Ole32.dll |