Función WPUQuerySocketHandleContext (ws2spi.h)

  • Artículo

La función WPUQuerySocketHandleContext consulta el valor de contexto asociado al identificador de socket especificado.

Sintaxis

int WPUQuerySocketHandleContext(
  [in]  SOCKET     s,
  [out] PDWORD_PTR lpContext,
  [out] LPINT      lpErrno
);

Parámetros

[in] s

Descripción que identifica el socket cuyo contexto se va a consultar.

[out] lpContext

Puntero que recibirá el valor de contexto.

[out] lpErrno

Puntero al código de error.

Valor devuelto

Si no se produce ningún error, WPUQuerySocketHandleContext devuelve cero y almacena el valor de contexto actual en lpContext. De lo contrario, devuelve SOCKET_ERROR y un código de error específico está disponible en lpErrno.

Código de error Significado
WSAENOTSOCK
 El descriptor no es un socket creado por WPUCreateSocketHandle.
 
 

Comentarios

La función WPUQuerySocketHandleContext consulta el valor de contexto actual asociado al identificador de socket especificado. Normalmente, los proveedores de servicios usan esta función para recuperar un puntero a datos específicos del proveedor asociados al socket. Por ejemplo, un proveedor de servicios puede usar el contexto de socket para almacenar un puntero a una estructura que contiene el estado del socket, las direcciones de transporte local y remota, y los objetos de evento para señalar eventos de red.

Solo los proveedores que no son IFS usan esta función, ya que los proveedores IFS no pueden proporcionar un valor de contexto.

Requisitos

Requisito Value
Cliente mínimo compatible Windows 2000 Professional [solo aplicaciones de escritorio]
Servidor mínimo compatible Windows 2000 Server [solo aplicaciones de escritorio]
Plataforma de destino Windows
Encabezado ws2spi.h

Consulte también

WPUCreateSocketHandle