WsShutdownSessionChannel 함수(webservices.h)

  • 아티클

세션 채널에 대한 메시지의 끝을 알리는 데 사용됩니다.

구문

HRESULT WsShutdownSessionChannel(
  [in]           WS_CHANNEL             *channel,
  [in, optional] const WS_ASYNC_CONTEXT *asyncContext,
  [in, optional] WS_ERROR               *error
);

매개 변수

[in] channel

종료할 세션 채널입니다.

[in, optional] asyncContext

함수를 비동기적으로 호출하는 방법 또는 동기적으로 호출하는 경우 NULL 에 대한 정보입니다.

[in, optional] error

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

반환 값

이 함수는 이러한 값 중 하나를 반환할 수 있습니다.

반환 코드 설명
WS_E_INVALID_OPERATION
 채널이 WS_CHANNEL_STATE_OPEN 상태가 아닌 경우 반환됩니다.

설명

이 함수는 모든 메시지가 채널에 대해 전송되었음을 원격 당사자에게 나타냅니다.

원격 당사자는 메시지를 받을 때 WS_S_END 반환 값을 검색하여 채널에서 더 이상 메시지를 사용할 수 없음을 감지할 수 있습니다. ( Windows Web Services 반환 값을 참조하세요.) 그러나 채널 계층 개요에 설명된 대로 비 애플리케이션 메시지가 채널에 의해 필터링된 경우에도 메시지를 사용할 수 없게 될 수 있습니다. 세션 종료는 이전 메시지가 수신되었는지 여부를 추적하여 메시지 필터링과 구별할 수 있습니다. 이전 메시지를 받은 경우 세션이 종료되었습니다.

이 함수는 메시지 전송을 지원하는 세션이 있는 WS_CHANNEL_TYPE 만든 채널에만 적용됩니다.

채널은 WS_CHANNEL_STATE_OPEN 상태여야 합니다.

이 함수가 성공하면 WS_CHANNEL_PROPERTY_IS_SESSION_SHUT_DOWN 속성의 값은 TRUE가 됩니다.

세션 채널이 종료되면 채널에서 메시지를 보내거나 채널을 종료하려고 하면 WS_E_INVALID_OPERATION 반환됩니다.

이 함수를 호출하는 것은 선택 사항입니다. WS_CHANNEL_STATE_OPEN 때 WsCloseChannel을 사용하여 세션 채널이 닫히면 닫기 프로세스의 일부로 채널이 자동으로 종료됩니다.

요구 사항

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