WinHttpWebSocketReceive 함수(winhttp.h)

  • 아티클

WinHttpWebSocketReceive 함수는 WebSocket 연결에서 데이터를 수신합니다.

구문

WINHTTPAPI DWORD WinHttpWebSocketReceive(
  [in]  HINTERNET                      hWebSocket,
  [out] PVOID                          pvBuffer,
  [in]  DWORD                          dwBufferLength,
  [out] DWORD                          *pdwBytesRead,
  [out] WINHTTP_WEB_SOCKET_BUFFER_TYPE *peBufferType
);

매개 변수

[in] hWebSocket

형식: HINTERNET

WebSocket에 대한 핸들입니다.

[out] pvBuffer

형식: PVOID

데이터를 수신할 버퍼에 대한 포인터입니다.

[in] dwBufferLength

형식:DWORD

pvBuffer의 길이(바이트)입니다.

[out] pdwBytesRead

형식: DWORD*

작업이 끝날 때 연결에서 읽은 바이트 수를 수신하는 DWORD 에 대한 포인터입니다. WinHttpWebSocketReceive가 NO_ERROR 반환하고 핸들이 동기 모드로 열린 경우에만 설정됩니다.

[out] peBufferType

형식: WINHTTP_WEB_SOCKET_BUFFER_TYPE*

반환된 버퍼의 형식입니다. WinHttpWebSocketReceive가 NO_ERROR 반환하고 핸들이 동기 모드로 열린 경우에만 설정됩니다.

반환 값

형식:DWORD

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

설명
ERROR_INVALID_OPERATION
 닫기 또는 수신이 보류 중이거나 수신 채널이 이미 닫혀 있습니다.
ERROR_INVALID_PARAMETER
 매개 변수가 잘못되었습니다.
ERROR_WINHTTP_INVALID_SERVER_RESPONSE
 서버에서 잘못된 데이터를 수신했습니다.
ERROR_WINHTTP_OPERATION_CANCELLED
 연결을 닫기 위해 WinHttpWebSocketClose 가 호출되었기 때문에 작업이 취소되었습니다.

요구 사항

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