WinHttpWebSocketShutdown 함수(winhttp.h)

WinHttpWebSocketShutdown 함수는 닫기 프레임을 WebSocket 서버로 보내 송신 채널을 닫지만 수신 채널을 열어 둡니다.

구문

WINHTTPAPI DWORD WinHttpWebSocketShutdown(
  [in]           HINTERNET hWebSocket,
  [in]           USHORT    usStatus,
  [in, optional] PVOID     pvReason,
  [in]           DWORD     dwReasonLength
);

매개 변수

[in] hWebSocket

형식: HINTERNET

WebSocket에 대한 핸들입니다.

참고WinHttpWebSocketShutdown 은 이 핸들을 닫지 않습니다. 핸들을 닫려면 더 이상 필요하지 않은 경우 hWebSocket에서 WinHttpCloseHandle을 호출합니다.

 

[in] usStatus

형식: USHORT

닫기 상태 코드입니다. 가능한 값은 WINHTTP_WEB_SOCKET_CLOSE_STATUS 참조하세요.

[in, optional] pvReason

형식: PVOID

닫는 자세한 이유입니다.

[in] dwReasonLength

형식:DWORD

pvReason의 길이(바이트)입니다.

pvReason이 NULL이면 0이어야 합니다. 이 값은 0~123 범위 내에 있어야 합니다.

반환 값

형식:DWORD

다음 예외를 제외하고 모든 오류 코드는 기본 TCP 연결이 중단되었음을 나타냅니다.

	Description
ERROR_IO_PENDING	작업이 비동기적으로 완료됩니다.

설명

WinHttpWebSocketShutdown 은 닫기 프레임을 보내고 WebSocket 연결을 통해 추가 데이터가 전송되지 않도록 합니다. 수신 채널을 닫지 않습니다. 연결을 완전히 닫고 후속 수신 작업을 방지하려면 WinHttpWebSocketClose 를 사용합니다.

애플리케이션은 정기적인 수신 작업을 통해 서버에서 닫기 프레임을 수신해야 합니다.

WinHttpWebSocketShutdown이 호출된 후 애플리케이션은 자체적으로 닫기 프레임을 수신하고 스택에 위임하지 않으려는 경우 WinHttpWebSocketClose를 호출할 수 있습니다.

요구 사항

지원되는 최소 클라이언트	Windows 8 [데스크톱 앱만 해당]
지원되는 최소 서버	Windows Server 2012 [데스크톱 앱만 해당]
대상 플랫폼	Windows
헤더	winhttp.h
라이브러리	Winhttp.lib
DLL	Winhttp.dll

추가 정보

WINHTTP_WEB_SOCKET_CLOSE_STATUS

WinHttpCloseHandle

WinHttpWebSocketClose