WinHttpWebSocketCompleteUpgrade

WinHttpSendRequest で開始した WebSocket ハンドシェイクを完了する。

WinHttpWebSocketCompleteUpgrade hRequest, pContext

hRequest : [intptr] 型: HINTERNET WebSocket ハンドシェイクの送信に使われた HTTP リクエストハンドル。
pContext : [int] 型: DWORD_PTR 新しいハンドルに関連付けるコンテキスト。

(プラグイン / モジュール : winhttp.dll)

解説

WinHttpSendRequest で開始した WebSocket ハンドシェイクを完了する。

[戻り値]
型: HINTERNET 新しい WebSocket ハンドル。NULL の場合は GetLastError
を呼び出して失敗の原因を判定する。

[備考]
WinHttpWebSocketCompleteUpgrade は、開かれた HTTP リクエストに対して呼び出し、他の
WebSocket 操作を行うための WebSocket ハンドルを取得できる。リクエストを送信する前に、WinHttpSetOption
を WINHTTP_OPTION_UPGRADE_TO_WEB_SOCKET で呼び出してリクエストハンドルを WebSocket
アップグレードとしてマークする必要がある。呼び出し側はサーバーが返した HTTP ステータスコードを確認し、ステータスコードが 101
の場合にのみこの関数を呼び出すべきである。それ以外のステータスコードで呼び出すと失敗する。

情報