Fonction PeerDistServerCancelAsyncOperation (peerdist.h)

Article
03/04/2024

La fonction PeerDistServerCancelAsyncOperation annule l’opération asynchrone associée à l’identificateur de contenu et à la structure CHEVAUCHEMENT.

Syntaxe

DWORD PeerDistServerCancelAsyncOperation(
  [in] PEERDIST_INSTANCE_HANDLE hPeerDist,
       DWORD                    cbContentIdentifier,
  [in] PBYTE                    pContentIdentifier,
  [in] LPOVERLAPPED             pOverlapped
);

Paramètres

[in] hPeerDist

Un PEERDIST_INSTANCE_HANDLE retourné par PeerDistStartup.

cbContentIdentifier

Longueur, en octets, de l’identificateur de contenu.

[in] pContentIdentifier

Pointeur vers un tableau qui contient l’identificateur de contenu.

[in] pOverlapped

Pointeur vers une structure CHEVAUCHEMENT qui contient les données d’opération asynchrone d’annulation.

Valeur retournée

La fonction retourne ERROR_SUCCESS valeur si l’opération associée à la structure OVERLAPPED est annulée. 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 pour la structure CHEVAUCHEMENT 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 PeerDistServerCancelAsyncOperation .

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 PeerDistServerCancelAsyncOperation 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

PeerDistClientCancelAsyncOperation

PeerDistClientOpenContent

Partager via