WebSocketBeginClientHandshake 함수(websocket.h)

WebSocketBeginClientHandshake 함수는 클라이언트 쪽 핸드셰이크를 시작합니다.

구문

HRESULT WebSocketBeginClientHandshake(
  [in]           WEB_SOCKET_HANDLE             hWebSocket,
  [in, optional] PCSTR                         *pszSubprotocols,
  [in]           ULONG                         ulSubprotocolCount,
  [in, optional] PCSTR                         *pszExtensions,
  [in]           ULONG                         ulExtensionCount,
  [in, optional] const PWEB_SOCKET_HTTP_HEADER pInitialHeaders,
  [in]           ULONG                         ulInitialHeaderCount,
  [out]          PWEB_SOCKET_HTTP_HEADER       *pAdditionalHeaders,
  [out]          ULONG                         *pulAdditionalHeaderCount
);

매개 변수

[in] hWebSocket

형식: WEB_SOCKET_HANDLE

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

[in, optional] pszSubprotocols

형식: PCSTR*

애플리케이션에서 선택한 하위 프로토콜 배열에 대한 포인터입니다. 클라이언트-서버 핸드셰이크가 완료되면 애플리케이션은 WebSocketEndClientHandshake에서 반환된 하위 프로토콜을 사용해야 합니다. 항목당 하나의 하위 프로토콜을 포함해야 합니다.

[in] ulSubprotocolCount

형식: ULONG

pszSubprotocols의 하위 프로토콜 수입니다.

[in, optional] pszExtensions

형식: PCSTR*

애플리케이션에서 선택한 확장 배열에 대한 포인터입니다. 클라이언트-서버 핸드셰이크가 완료되면 애플리케이션은 WebSocketEndClientHandshake에서 반환된 확장을 사용해야 합니다. 항목당 하나의 확장을 포함해야 합니다.

[in] ulExtensionCount

형식: ULONG

pszExtensions의 확장 수입니다.

[in, optional] pInitialHeaders

형식: const PWEB_SOCKET_HTTP_HEADER

애플리케이션에서 보낼 요청 헤더를 포함하는 WEB_SOCKET_HTTP_HEADER 구조체의 배열에 대한 포인터입니다. 배열에는 RFC 2616에 정의된 대로 호스트 HTTP 헤더가 포함되어야 합니다.

[in] ulInitialHeaderCount

형식: ULONG

pInitialHeaders의 요청 헤더 수입니다.

[out] pAdditionalHeaders

형식: PWEB_SOCKET_HTTP_HEADER

성공적인 출력에서 애플리케이션에서 보낼 요청 헤더를 포함하는 WEB_SOCKET_HTTP_HEADER 구조의 배열에 대한 포인터입니다. 이러한 헤더가 pInitialHeaders에 지정된 경우 헤더를 바꿔야 합니다.

[out] pulAdditionalHeaderCount

형식: ULONG*

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

반환 값

형식: HRESULT

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

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

설명

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

요구 사항

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

추가 정보

WEB_SOCKET_HTTP_HEADER

WebSocketBeginServerHandshake

WebSocketEndClientHandshake

WebSocketEndServerHandshake