WinAPPCCancelAsyncRequest

La fonction WinAPPCCancelAsyncRequest annule une requête WinAsyncAPPC en suspens.

Syntaxe

  
    int WINAPI WinAPPCCancelAsyncRequest(   
HANDLE hAsyncTaskID);  

Paramètres

hAsyncTaskID
Paramètre fourni. Spécifie la tâche asynchrone à annuler.

Valeur de retour

La valeur de retour spécifie si la requête asynchrone a été annulée. Si la valeur est égale à zéro, la requête a été annulée. Sinon, la valeur est l’une des suivantes :

WAPPCINVALID
Code d’erreur indiquant que l’identificateur de tâche asynchrone spécifié n’était pas valide.

WAPPCALREADY
Code d’erreur indiquant que la routine asynchrone en cours d’annulation est déjà terminée.

Remarques

Une tâche asynchrone précédemment initiée par l’émission de l’une des fonctions WinAsyncAPPC, WinAsyncAPPCEx ou WinAsyncAPPCIOCP peut être annulée avant la fin en émettant la fonction WinAPPCCancelAsyncRequest , en spécifiant l’identificateur de tâche asynchrone tel qu’il est retourné par la fonction initiale dans hAsyncTaskID.

Si le verbe en suspens est lié à une conversation (par exemple, SEND_DATA ou RECEIVE_AND_WAIT), le verbe est vidé et la session est fermée. Si le verbe est lié à un TP (par exemple, RECEIVE_ALLOCATE ou TP_STARTED), le TP est terminé. Dans les deux cas, alors que l’implémentation ferme les conversations et les sessions aussi proprement que possible, elle n’envoie pas de mémoires tampons, attendez les confirmations, et ainsi de suite. Cet appel est synchrone et, une fois le traitement décrit ci-dessus terminé, un message d’achèvement est publié pour le verbe annulé.

Si une tentative d’annulation d’une routine WinAsyncAPPC asynchrone existante échoue avec un code d’erreur de WAPPCALREADY, l’une des deux choses s’est produite. La routine d’origine est déjà terminée et l’application a traité le message résultant, ou la routine d’origine est déjà terminée et le message résultant est toujours en attente dans la file d’attente de la fenêtre de l’application.