PeerDistServerCancelAsyncOperation 함수(peerdist.h)

  • 아티클

PeerDistServerCancelAsyncOperation 함수는 콘텐츠 식별자 및 OVERLAPPED 구조체와 연결된 비동기 작업을 취소합니다.

구문

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

매개 변수

[in] hPeerDist

PeerDistStartup에서 반환된 PEERDIST_INSTANCE_HANDLE.

cbContentIdentifier

콘텐츠 식별자의 길이(바이트)입니다.

[in] pContentIdentifier

콘텐츠 식별자를 포함하는 배열에 대한 포인터입니다.

[in] pOverlapped

취소 비동기 작업 데이터가 포함된 OVERLAPPED 구조체에 대한 포인터입니다.

반환 값

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

반환 코드 설명
ERROR_INVALID_PARAMETER
 하나 이상의 매개 변수가 잘못되었습니다.
ERROR_INVALID_HANDLE
 hPeerDist 핸들이 잘못되었습니다.
PEERDIST_ERROR_OPERATION_NOT_FOUND
 OVERLAPPED 구조체에 대한 작업을 찾을 수 없습니다.
ERROR_ACCESS_DISABLED_BY_POLICY
 이 기능은 그룹 정책 사용하지 않도록 설정됩니다.
PEERDIST_ERROR_SERVICE_UNAVAILABLE
 서비스를 사용할 수 없습니다.

설명

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

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

성공적으로 취소된 작업을 확인하려면 GetOverlappedResult 에 대한 호출을 수행해야 하며 예상 반환은 FALSE입니다.

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

요구 사항

요구 사항 값
지원되는 최소 클라이언트 Windows 7 Professional [데스크톱 앱만 해당]
지원되는 최소 서버 Windows Server 2008 R2 [데스크톱 앱만 해당]
대상 플랫폼 Windows
헤더 peerdist.h
라이브러리 PeerDist.lib
DLL PeerDist.dll

추가 정보

PeerDistClientCancelAsyncOperation

PeerDistClientOpenContent