Compartir a través de

Función PeerDistServerCancelAsyncOperation (peerdist.h)

  • Artículo

La función PeerDistServerCancelAsyncOperation cancela la operación asincrónica asociada con el identificador de contenido y la estructura SUPERPUESTA .

Sintaxis

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

Parámetros

[in] hPeerDist

Un PEERDIST_INSTANCE_HANDLE devuelto por PeerDistStartup.

cbContentIdentifier

Longitud, en bytes, del identificador de contenido.

[in] pContentIdentifier

Puntero a una matriz que contiene el identificador de contenido.

[in] pOverlapped

Puntero a una estructura SUPERPUESTA que contiene los datos de operación asincrónicos de cancelación.

Valor devuelto

La función devolverá ERROR_SUCCESS valor si la operación asociada a la estructura SUPERPUESTA 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 para la estructura SUPERPUESTA .
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 volverá hasta que el resultado de 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 PeerDistServerCancelAsyncOperation .

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 un retorno esperado de FALSE.

Además, al llamar a GetLastError inmediatamente después de que peerDistServerCancelAsyncOperation se realice correctamente, se devolverá el código de error 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

PeerDistClientCancelAsyncOperation

PeerDistClientOpenContent