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을 참조하세요.

요구 사항