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 |