WinHttpWebSocketClose 함수(winhttp.h)

WinHttpWebSocketClose 함수는 WebSocket 연결을 닫습니다.

구문

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

매개 변수

[in] hWebSocket

형식: HINTERNET

WebSocket에 대한 핸들입니다.

WinHttpWebSocketClose는 이 핸들을 닫지 않습니다. 핸들을 닫으려면 더 이상 필요하지 않은 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_INVALID_OPERATION
닫기 또는 보내기가 보류 중입니다.
ERROR_INVALID_PARAMETER
매개 변수가 잘못되었습니다.
ERROR_INVALID_SERVER_RESPONSE
서버에서 잘못된 데이터를 수신했습니다.

설명

WinHttpWebSocketClose 는 WebSocket 연결을 완전히 닫습니다. 수신 채널을 열어 두고 송신 채널을 닫려면 WinHttpWebSocketShutdown을 사용합니다.

일반 수신 작업 중에 닫기 프레임을 받을 수 있습니다. 이 경우 WinHttpWebSocketClose 도 닫기 프레임을 보냅니다.

닫기 타이머는 속성 WINHTTP_OPTION_WEB_SOCKET_CLOSE_TIMEOUT 설정할 수 있습니다. 기본값은 10초입니다.

요구 사항

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

추가 정보

WINHTTP_WEB_SOCKET_CLOSE_STATUS

WinHttpCloseHandle

WinHttpWebSocketShutdown