Compartir a través de

Función PeerDistClientCancelAsyncOperation (peerdist.h)

  • Artículo

La función PeerDistClientCancelAsyncOperation cancela la operación asincrónica asociada a una estructura SUPERPUESTA y el identificador de contenido devuelto por PeerDistClientOpenContent.

Sintaxis

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

Parámetros

[in] hPeerDist

Una PEERDIST_INSTANCE_HANDLE devuelta por PeerDistStartup.

[in] hContentHandle

Identificador de contenido abierto por la llamada de función PeerDistClientOpenContent .

[in, optional] pOverlapped

Puntero a una estructura SUPERPUESTA que contiene los datos de operación asincrónica de cancelación. Si el puntero es NULL , se cancelarán todas las operaciones asincrónicas para el identificador de contenido especificado.

Valor devuelto

La función devolverá ERROR_SUCCESS valor si la operación asociada a la estructura SUPERPUESTA especificada se cancela correctamente. De lo contrario, es posible que la función devuelva uno de los siguientes valores:

Código devuelto Descripción
ERROR_INVALID_PARAMETER
 Uno o varios parámetros no son válidos.
ERROR_INVALID_HANDLE
 El identificador hPeerDist no es válido.
PEERDIST_ERROR_OPERATION_NOT_FOUND
 No se encuentra la operación asociada a la estructura SUPERPUESTA especificada.
ERROR_ACCESS_DISABLED_BY_POLICY
 La característica está deshabilitada por directiva de grupo.
PEERDIST_ERROR_SERVICE_UNAVAILABLE
 El servicio no está disponible.

Comentarios

Esta función cancelará sincrónicamente la operación, pero no devolverá hasta que el resultado de la cancelación se publique en el puerto de finalización o el evento de espera se establezca en el estado señalado. Cualquier subproceso en espera puede recibir el aviso de finalización de la operación antes o después de que se devuelva la función PeerDistClientCancelAsyncOperation .

Esta función no garantiza que la operación se complete como cancelada. El resultado de la cancelación solo se publicará si no se han publicado otros resultados.

Para confirmar las operaciones canceladas correctamente, se debe realizar una llamada a GetOverlappedResult con una devolución esperada de FALSE.

Además, al llamar a GetLastError inmediatamente después de que peerDistClientCancelAsyncOperation se realice correctamente, se devolverá el código de error de ERROR_OPERATION_ABORTED .

Requisitos

Requisito Value
Cliente mínimo compatible Windows 7 Professional [solo aplicaciones de escritorio]
Servidor mínimo compatible Windows Server 2008 R2 [solo aplicaciones de escritorio]
Plataforma de destino Windows
Encabezado peerdist.h
Library PeerDist.lib
Archivo DLL PeerDist.dll

Consulte también

PeerDistServerCancelAsyncOperation