WebSocketBeginServerHandshake 함수(websocket.h)

WebSocketBeginServerHandshake 함수는 서버 쪽 핸드셰이크를 시작합니다.

구문

HRESULT WebSocketBeginServerHandshake(
  [in]           WEB_SOCKET_HANDLE             hWebSocket,
  [in, optional] PCSTR                         pszSubprotocolSelected,
  [in, optional] PCSTR                         *pszExtensionSelected,
  [in]           ULONG                         ulExtensionSelectedCount,
  [in]           const PWEB_SOCKET_HTTP_HEADER pRequestHeaders,
  [in]           ULONG                         ulRequestHeaderCount,
  [out]          PWEB_SOCKET_HTTP_HEADER       *pResponseHeaders,
  [out]          ULONG                         *pulResponseHeaderCount
);

매개 변수

[in] hWebSocket

형식: WEB_SOCKET_HANDLE

WebSocketCreateServerHandle에 대한 이전 호출에서 반환된 WebSocket 세션 핸들입니다.

[in, optional] pszSubprotocolSelected

형식: PCSTR

애플리케이션에서 선택한 하위 프로토콜 값에 대한 포인터입니다. 하나의 하위 프로토콜을 포함해야 합니다.

[in, optional] pszExtensionSelected

형식: PCSTR*

애플리케이션에서 선택한 확장 목록에 대한 포인터입니다. 항목당 하나의 확장이 포함되어야 합니다.

[in] ulExtensionSelectedCount

형식: ULONG

pszExtensionSelected의 확장 수입니다.

[in] pRequestHeaders

형식: const PWEB_SOCKET_HTTP_HEADER

애플리케이션에서 받은 요청 헤더를 포함하는 WEB_SOCKET_HTTP_HEADER 구조체의 배열에 대한 포인터입니다.

[in] ulRequestHeaderCount

형식: ULONG

pRequestHeaders의 요청 헤더 수입니다.

[out] pResponseHeaders

형식: PWEB_SOCKET_HTTP_HEADER*

성공적인 출력에서 애플리케이션에서 보낼 응답 헤더를 포함하는 배열 또는 WEB_SOCKET_HTTP_HEADER 구조체에 대한 포인터입니다.

[out] pulResponseHeaderCount

형식: ULONG*

성공적인 출력에서 pResponseHeaders의 응답 헤더 수입니다.

반환 값

형식: HRESULT

함수가 성공하면 S_OK를 반환합니다.

함수가 실패하면 WinError.h에 정의된 다음 또는 시스템 오류 코드 중 하나를 반환합니다.

반환 코드	설명
E_INVALID_PROTOCOL_FORMAT	프로토콜 데이터의 형식이 잘못되었습니다.

설명

서버 쪽 핸드셰이크를 완료하려면 애플리케이션 에서 WebSocketEndServerHandshake 또는 세션 함수를 호출해야 합니다. 클라이언트-서버 핸드셰이크가 완료되면 애플리케이션에서 세션 함수를 사용할 수 있습니다.

요구 사항

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

추가 정보

WEB_SOCKET_HTTP_HEADER

WebSocketBeginClientHandshake

WebSocketEndClientHandshake

WebSocketEndServerHandshake