WsRegisterOperationForCancel 함수(webservices.h)

서비스 작업은 이 함수를 사용하여 취소 알림을 등록할 수 있습니다. 서비스 작업이 실행 중일 때만 이 API를 호출하는 것이 유효합니다. 서비스 작업이 완료된 후 호출하는 동작은 지원되지 않습니다.

이 API가 호출되고 런타임에서 서비스 작업의 취소가 필요하다고 판단한 동안 애플리케이션에서 이 API를 호출하는 동안 콜백을 호출할 수 있습니다.

따라서 호출자는 WsRegisterOperationForCancel이 호출되는 즉시 런타임이 콜백 WS_OPERATION_CANCEL_CALLBACK 호출할 수 있다고 가정해야 합니다.

구문

HRESULT WsRegisterOperationForCancel(
  [in]           const WS_OPERATION_CONTEXT       *context,
  [in]           WS_OPERATION_CANCEL_CALLBACK     cancelCallback,
  [in, optional] WS_OPERATION_FREE_STATE_CALLBACK freestateCallback,
  [in, optional] void                             *userState,
  [in, optional] WS_ERROR                         *error
);

매개 변수

[in] context

속성 값을 가져오는 컨텍스트입니다.

[in] cancelCallback

취소 알림 함수에 대한 함수 포인터입니다.

[in, optional] freestateCallback

자유 상태 호출에 대한 함수 포인터를 지정하는 선택적 매개 변수입니다.

[in, optional] userState

호출 데이터를 식별하는 데 사용할 수 있는 애플리케이션별 상태를 지정하는 선택적 매개 변수입니다.

[in, optional] error

함수가 실패할 경우 추가 오류 정보를 저장할 위치를 지정합니다.

반환 값

이 함수가 성공하면 S_OK 반환합니다. 성공하지 않으면 HRESULT 오류 코드를 반환합니다.

요구 사항

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