Compartir a través de

Función WinHttpWebSocketCompleteUpgrade (winhttp.h)

  • Artículo

La función WinHttpWebSocketCompleteUpgrade completa un protocolo de enlace WebSocket iniciado por WinHttpSendRequest.

Sintaxis

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

Parámetros

[in] hRequest

Tipo: HINTERNET

Identificador de solicitud HTTP usado para enviar un protocolo de enlace WebSocket.

[in, optional] pContext

Tipo: DWORD_PTR

Contexto que se va a asociar al nuevo identificador.

Valor devuelto

Tipo: HINTERNET

Nuevo identificador de WebSocket. Si es NULL, llame a GetLastError para determinar la causa del error.

Comentarios

Se puede llamar a WinHttpWebSocketCompleteUpgrade en una solicitud HTTP abierta para obtener un identificador de WebSocket para realizar otras operaciones de WebSocket.

El identificador de solicitud debe marcarse como una actualización de WebSocket mediante una llamada a WinHttpSetOption con WINHTTP_OPTION_UPGRADE_TO_WEB_SOCKET antes de enviar la solicitud.

El autor de la llamada debe comprobar el código de estado HTTP devuelto por el servidor y llamar a esta función solo si el código de estado era 101. Si se llama con cualquier otro código de estado, se producirá un error.

Requisitos

   
Cliente mínimo compatible Windows 8 [solo aplicaciones de escritorio]
Servidor mínimo compatible Windows Server 2012 [solo aplicaciones de escritorio]
Plataforma de destino Windows
Encabezado winhttp.h
Library Winhttp.lib
Archivo DLL Winhttp.dll