PeerDistClientCancelAsyncOperation 함수(peerdist.h)

PeerDistClientCancelAsyncOperation 함수는 OVERLAPPED 구조와 연결된 비동기 작업과 PeerDistClientOpenContent에서 반환된 콘텐츠 핸들을 취소합니다.

구문

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

매개 변수

[in] hPeerDist

PeerDistStartup에서 반환된 PEERDIST_INSTANCE_HANDLE.

[in] hContentHandle

PeerDistClientOpenContent 함수 호출에서 연 콘텐츠 핸들입니다.

[in, optional] pOverlapped

취소 비동기 작업 데이터를 포함하는 OVERLAPPED 구조체에 대한 포인터입니다. 포인터가 NULL 이면 지정된 콘텐츠 핸들에 대한 모든 비동기 작업이 취소됩니다.

반환 값

지정된 OVERLAPPED 구조체와 연결된 작업이 성공적으로 취소된 경우 함수는 ERROR_SUCCESS 값을 반환합니다. 그렇지 않은 경우에는 함수가 다음 값 중 하나를 반환할 수 있습니다.

설명

이 함수는 작업을 동기적으로 취소하지만 취소 결과가 완료 포트에 게시되거나 대기 이벤트가 신호됨 상태로 설정될 때까지 반환되지 않습니다. 대기 중인 모든 스레드는 PeerDistClientCancelAsyncOperation 함수가 반환되기 전이나 후에 작업에 대한 완료 알림을 받을 수 있습니다.

이 함수는 작업이 취소된 대로 완료된다는 것을 보장하지 않습니다. 취소 결과는 다른 결과가 게시되지 않은 경우에만 게시됩니다.

작업이 성공적으로 취소되었는지 확인하려면 예상되는 FALSE 반환을 사용하여 GetOverlappedResult를 호출해야 합니다.

또한 성공적인 PeerDistClientCancelAsyncOperation 직후 GetLastError를 호출하면 ERROR_OPERATION_ABORTED 오류 코드가 반환됩니다.

요구 사항

추가 정보

PeerDistServerCancelAsyncOperation