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 | |
|---|---|
|
작업이 비동기적으로 완료됩니다. |
설명
WinHttpWebSocketShutdown 은 닫기 프레임을 보내고 WebSocket 연결을 통해 추가 데이터가 전송되지 않도록 합니다. 수신 채널을 닫지 않습니다. 연결을 완전히 닫고 후속 수신 작업을 방지하려면 WinHttpWebSocketClose 를 사용합니다.
애플리케이션은 정기적인 수신 작업을 통해 서버에서 닫기 프레임을 수신해야 합니다.
WinHttpWebSocketShutdown이 호출된 후 애플리케이션은 자체적으로 닫기 프레임을 수신하고 스택에 위임하지 않으려는 경우 WinHttpWebSocketClose를 호출할 수 있습니다.
요구 사항
| 지원되는 최소 클라이언트 | Windows 8 [데스크톱 앱만 해당] |
| 지원되는 최소 서버 | Windows Server 2012 [데스크톱 앱만 해당] |
| 대상 플랫폼 | Windows |
| 헤더 | winhttp.h |
| 라이브러리 | Winhttp.lib |
| DLL | Winhttp.dll |