WinHttpWebSocketCompleteUpgrade 함수(winhttp.h)

  • 아티클

WinHttpWebSocketCompleteUpgrade 함수는 WinHttpSendRequest에서 시작한 WebSocket 핸드셰이크를 완료합니다.

구문

WINHTTPAPI HINTERNET WinHttpWebSocketCompleteUpgrade(
  [in]           HINTERNET hRequest,
  [in, optional] DWORD_PTR pContext
);

매개 변수

[in] hRequest

형식: HINTERNET

WebSocket 핸드셰이크를 보내는 데 사용되는 HTTP 요청 핸들입니다.

[in, optional] pContext

형식: DWORD_PTR

새 핸들과 연결할 컨텍스트입니다.

반환 값

형식: HINTERNET

새 WebSocket 핸들입니다. NULL인 경우 GetLastError 를 호출하여 실패 원인을 확인합니다.

설명

WinHttpWebSocketCompleteUpgrade 는 열려 있는 HTTP 요청에서 호출하여 다른 WebSocket 작업을 수행하기 위한 WebSocket 핸들을 가져올 수 있습니다.

요청을 보내기 전에 WINHTTP_OPTION_UPGRADE_TO_WEB_SOCKETWinHttpSetOption을 호출하여 요청 핸들을 WebSocket 업그레이드로 표시해야 합니다.

호출자는 서버에서 반환된 HTTP 상태 코드를 검사 상태 코드가 101인 경우에만 이 함수를 호출해야 합니다. 다른 상태 코드로 호출하면 오류가 발생합니다.

요구 사항

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