WebSocketEndClientHandshake 함수(websocket.h)
WebSocketEndClientHandshake 함수는 클라이언트 쪽 핸드셰이크를 완료합니다.
구문
HRESULT WebSocketEndClientHandshake(
[in] WEB_SOCKET_HANDLE hWebSocket,
[in] const PWEB_SOCKET_HTTP_HEADER pResponseHeaders,
[in] ULONG ulReponseHeaderCount,
[in, out, optional] ULONG *pulSelectedExtensions,
[in, out, optional] ULONG *pulSelectedExtensionCount,
[in, out, optional] ULONG *pulSelectedSubprotocol
);
매개 변수
[in] hWebSocket
WebSocketCreateClientHandle에 대한 이전 호출에서 반환된 WebSocket 세션 핸들입니다.
[in] pResponseHeaders
형식: const PWEB_SOCKET_HTTP_HEADER
애플리케이션에서 받은 응답 헤더를 포함하는 WEB_SOCKET_HTTP_HEADER 구조체의 배열에 대한 포인터입니다.
[in] ulReponseHeaderCount
형식: ULONG
pResponseHeaders의 응답 헤더 수입니다.
[in, out, optional] pulSelectedExtensions
형식: ULONG*
입력에서 애플리케이션에서 할당한 배열에 대한 포인터입니다. 성공적인 출력에서 클라이언트-서버 핸드셰이크 중에 서버에서 선택한 확장을 나타내는 숫자 배열에 대한 포인터입니다. 이 숫자는 WebSocketBeginClientHandshake의 pszExtensions에 전달된 확장 배열에 대한 0부터 시작하는 인덱스입니다.
[in, out, optional] pulSelectedExtensionCount
형식: ULONG*
입력에서 pulSelectedExtensions에 할당된 확장의 수입니다. WebSocketEndClientHandshake에서 ulExtensionCount에 전달된 숫자와 적어도 같아야 합니다. 성공적인 출력에서 pulSelectedExtensions에서 반환된 확장의 수입니다.
[in, out, optional] pulSelectedSubprotocol
형식: ULONG*
성공적인 출력에서 클라이언트-서버 핸드셰이크 중에 서버에서 선택한 하위 프로토콜을 나타내는 숫자를 가리키는 포인터입니다. 이 숫자는 WebSocketBeginClientHandshake의 pszSubprotocols에 전달된 하위 프로토콜 배열의 인덱스(0부터 시작)입니다.
반환 값
형식: HRESULT
함수가 성공하면 S_OK를 반환합니다.
함수가 실패하면 WinError.h에 정의된 다음 또는 시스템 오류 코드 중 하나를 반환합니다.
| 반환 코드 | 설명 |
|---|---|
|
프로토콜 데이터의 형식이 잘못되었습니다. |
|
서버는 애플리케이션에서 지정한 하위 프로토콜을 허용하지 않습니다. |
|
서버는 애플리케이션에서 지정한 확장을 허용하지 않습니다. |
설명
WebSocketBeginClientHandshake에 대한 이전 호출 후 클라이언트 쪽 핸드셰이크를 완료하려면 이 함수를 호출해야 합니다. 클라이언트-서버 핸드셰이크가 완료되면 애플리케이션에서 세션 함수를 사용할 수 있습니다.
요구 사항
| 지원되는 최소 클라이언트 | Windows 8 [데스크톱 앱만 해당] |
| 지원되는 최소 서버 | Windows Server 2012 [데스크톱 앱만 해당] |
| 대상 플랫폼 | Windows |
| 헤더 | websocket.h |
| 라이브러리 | Websocket.lib |
| DLL | Websocket.dll |