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*

사용된 바이트 수입니다. pvReason이 NULL이고 dwReasonLength가 0이면 pdwReasonLengthConsumed에는 호출 애플리케이션에서 할당해야 하는 버퍼의 크기가 포함됩니다.

반환 값

형식:DWORD

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

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

설명

WinHttpWebSocketClose가 성공하거나 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