Fonction PeerDistClientCancelAsyncOperation (peerdist.h)

Article
03/06/2024

La fonction PeerDistClientCancelAsyncOperation annule l’opération asynchrone associée à une structure OVERLAPPED et le handle de contenu retourné par PeerDistClientOpenContent.

Syntaxe

DWORD PeerDistClientCancelAsyncOperation(
  [in]           PEERDIST_INSTANCE_HANDLE hPeerDist,
  [in]           PEERDIST_CONTENT_HANDLE  hContentHandle,
  [in, optional] LPOVERLAPPED             pOverlapped
);

Paramètres

[in] hPeerDist

Un PEERDIST_INSTANCE_HANDLE retourné par PeerDistStartup.

[in] hContentHandle

Handle de contenu ouvert par l’appel de fonction PeerDistClientOpenContent .

[in, optional] pOverlapped

Pointeur vers une structure CHEVAUCHEMENT qui contient les données d’opération asynchrone d’annulation. Si le pointeur a la valeur NULL , toutes les opérations asynchrones pour le handle de contenu spécifié sont annulées.

Valeur retournée

La fonction retourne ERROR_SUCCESS valeur si l’opération associée à la structure CHEVAUCHEMENT SPÉCIFIÉE est annulée avec succès. Sinon, la fonction peut retourner l’une des valeurs suivantes :

Code de retour	Description
ERROR_INVALID_PARAMETER	Un ou plusieurs paramètres ne sont pas valides.
ERROR_INVALID_HANDLE	Le handle hPeerDist n’est pas valide.
PEERDIST_ERROR_OPERATION_NOT_FOUND	L’opération associée à la structure CHEVAUCHEMENT SPÉCIFIÉE est introuvable.
ERROR_ACCESS_DISABLED_BY_POLICY	La fonctionnalité est désactivée par stratégie de groupe.
PEERDIST_ERROR_SERVICE_UNAVAILABLE	Le service n’est pas disponible.

Remarques

Cette fonction annule de manière synchrone l’opération, mais ne retourne pas tant que le résultat de l’annulation n’est pas publié sur le port d’achèvement ou que l’événement d’attente n’est pas défini à l’état signalé. Tous les threads en attente peuvent recevoir l’avis d’achèvement de l’opération avant ou après le retour de la fonction PeerDistClientCancelAsyncOperation .

Cette fonction ne garantit pas que l’opération se terminera comme annulée. Le résultat de l’annulation n’est publié que si aucun autre résultat n’a été publié.

Pour confirmer la réussite des opérations annulées, un appel doit être effectué à GetOverlappedResult avec un retour attendu de FALSE.

En outre, l’appel de GetLastError immédiatement après la réussite d’un PeerDistClientCancelAsyncOperation retourne le code d’erreur ERROR_OPERATION_ABORTED .

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows 7 Professionnel [applications de bureau uniquement]
Serveur minimal pris en charge	Windows Server 2008 R2 [applications de bureau uniquement]
Plateforme cible	Windows
En-tête	peerdist.h
Bibliothèque	PeerDist.lib
DLL	PeerDist.dll

Voir aussi

PeerDistServerCancelAsyncOperation

Partager via