Função PeerDistServerCancelAsyncOperation (peerdist.h)

  • Artigo

A função PeerDistServerCancelAsyncOperation cancela a operação assíncrona associada ao identificador de conteúdo e à estrutura OVERLAPPED .

Sintaxe

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

Parâmetros

[in] hPeerDist

Um PEERDIST_INSTANCE_HANDLE retornado por PeerDistStartup.

cbContentIdentifier

O comprimento, em bytes, do identificador de conteúdo.

[in] pContentIdentifier

Ponteiro para uma matriz que contém o identificador de conteúdo.

[in] pOverlapped

Ponteiro para uma estrutura OVERLAPPED que contém os dados de operação assíncrona de cancelamento.

Retornar valor

A função retornará ERROR_SUCCESS valor se a operação associada à estrutura OVERLAPPED for cancelada com êxito. Caso contrário, a função pode retornar um dos seguintes valores:

Código de retorno Descrição
ERROR_INVALID_PARAMETER
 Um ou mais parâmetros são inválidos.
ERROR_INVALID_HANDLE
 O identificador hPeerDist é inválido.
PEERDIST_ERROR_OPERATION_NOT_FOUND
 A operação para estrutura OVERLAPPED não pode ser encontrada.
ERROR_ACCESS_DISABLED_BY_POLICY
 O recurso é desabilitado por Política de Grupo.
PEERDIST_ERROR_SERVICE_UNAVAILABLE
 O serviço está indisponível.

Comentários

Essa função cancelará a operação de forma síncrona, mas não retornará até que o resultado do cancelamento seja postado na porta de conclusão ou o evento de espera seja definido como o estado "sinalizado". Todos os threads em espera podem receber o aviso de conclusão da operação antes ou depois que a função PeerDistServerCancelAsyncOperation retornar.

Essa função não garante que a operação será concluída como cancelada. O resultado do cancelamento será postado somente se nenhum outro resultado tiver sido postado.

Para confirmar as operações canceladas com êxito, uma chamada deve ser feita para GetOverlappedResult com um retorno esperado de FALSE.

Além disso, chamar GetLastError imediatamente após um PeerDistServerCancelAsyncOperation bem-sucedido retornará o código de erro ERROR_OPERATION_ABORTED .

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows 7 Professional [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Windows Server 2008 R2 [somente aplicativos da área de trabalho]
Plataforma de Destino Windows
Cabeçalho peerdist.h
Biblioteca PeerDist.lib
DLL PeerDist.dll

Confira também

PeerDistClientCancelAsyncOperation

PeerDistClientOpenContent