WsAbortServiceProxy 함수(webservices.h)
서비스 프록시를 중단하고 서비스 프록시에서 보류 중인 I/O를 취소합니다.
구문
HRESULT WsAbortServiceProxy(
[in] WS_SERVICE_PROXY *serviceProxy,
[in, optional] WS_ERROR *error
);
매개 변수
[in] serviceProxy
중단할 서비스 프록시를 나타내는 WS_SERVICE_PROXY 구조체에 대한 포인터입니다.
[in, optional] error
함수가 실패할 경우 추가 오류 정보를 수신하는 WS_ERROR 구조체에 대한 포인터입니다.
반환 값
함수가 성공하면 NO_ERROR 반환합니다. 그렇지 않으면 HRESULT 오류 코드를 반환합니다.
반환 코드 | 설명 |
---|---|
|
하나 이상의 인수가 잘못되었습니다. |
설명
WsAbortServiceProxy 는 서비스 프록시의 상태에 따라 다음 동작을 표시합니다(가능한 상태는 WS_SERVICE_PROXY_STATE 열거형 참조).
- 서비스 프록시가 열리고 WS_SERVICE_PROXY_STATE_OPENING 상태인 경우 WsAbortServiceProxy 를 호출하여 열기 작업을 중단할 수 있습니다. 서비스 프록시는 보류 중인 모든 I/O를 취소하고 WS_SERVICE_PROXY_STATE_CREATED 상태로 다시 전환합니다.
- 서비스 프록시가 이미 열려 있고 WS_SERVICE_PROXY_STATE_OPEN 상태인 경우 WsAbortServiceProxy 는 서비스 프록시가 모든 기본 채널을 중단하고 WS_SERVICE_PROXY_STATE_FAULTED 상태로 전환합니다. 중단이 시작되면 서비스 프록시는 새 호출을 수락하지 않습니다. 애플리케이션은 WsCloseServiceProxy 를 호출하여 닫을 수 있습니다.
- 서비스 프록시가 닫히고 WS_SERVICE_PROXY_STATE_CLOSING 상태이면 모든 기본 채널이 중단되고 서비스 프록시가 WS_SERVICE_PROXY_STATE_CLOSED 상태로 전환됩니다.
이 함수를 사용하는 예제는 ServiceCancellationExample을 참조하세요.
요구 사항
요구 사항 | 값 |
---|---|
지원되는 최소 클라이언트 | Windows 7 [데스크톱 앱 | UWP 앱] |
지원되는 최소 서버 | Windows Server 2008 R2 [데스크톱 앱 | UWP 앱] |
대상 플랫폼 | Windows |
헤더 | webservices.h |
라이브러리 | WebServices.lib |
DLL | WebServices.dll |