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