WinHttpWebSocketQueryCloseStatus 함수(winhttp.h)

WinHttpWebSocketQueryCloseStatus 함수는 서버에서 보낸 닫기 상태를 검색합니다.

구문

WINHTTPAPI DWORD WinHttpWebSocketQueryCloseStatus(
  [in]  HINTERNET hWebSocket,
  [out] USHORT    *pusStatus,
  [out] PVOID     pvReason,
  [in]  DWORD     dwReasonLength,
  [out] DWORD     *pdwReasonLengthConsumed
);

매개 변수

[in] hWebSocket

형식: HINTERNET

WebSocket에 대한 핸들

[out] pusStatus

형식: USHORT*

반환 시 채워질 닫기 상태 코드에 대한 포인터입니다. 가능한 값은 WINHTTP_WEB_SOCKET_CLOSE_STATUS 참조하세요.

[out] pvReason

형식: PVOID

반환 시 가까운 이유를 받을 버퍼에 대한 포인터입니다.

[in] dwReasonLength

형식:DWORD

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

[out] pdwReasonLengthConsumed

형식: DWORD*

사용된 바이트 수입니다. pvReasonNULL이고 dwReasonLength가 0인 경우 pdwReasonLengthConsumed는 호출 애플리케이션에서 할당해야 하는 버퍼의 크기를 포함합니다.

반환 값

형식:DWORD

성공에 NO_ERROR. 그렇지 않으면 오류 코드입니다.

설명
ERROR_INSUFFICIENT_BUFFER
pvReason에는 전체 가까운 이유를 작성하는 데 충분한 공간이 없습니다.
ERROR_INVALID_OPERATION
아직 닫기 프레임이 수신되지 않았습니다.
ERROR_INVALID_PARAMETER
매개 변수가 잘못되었습니다.

설명

WinHttpWebSocketQueryCloseStatusWinHttpWebSocketClose가 성공하거나 WinHttpWebSocketReceive가 WINHTTP_WEB_SOCKET_CLOSE_BUFFER_TYPE 반환하는 경우에만 WinHttpWebSocketQueryCloseStatus를 호출합니다.

pdwReasonLengthConsumed 는 123보다 크지 않으므로 버퍼를 123 이상으로 할당하면 ERROR_INSUFFICIENT_BUFFER 반환되지 않습니다.

요구 사항

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

참고 항목

WINHTTP_WEB_SOCKET_CLOSE_STATUS

WinHttpWebSocketClose

WinHttpWebSocketReceive