Función GetAcceptExSockaddrs (mswsock.h)

Artículo
08/25/2023

La función GetAcceptExSockaddrs analiza los datos obtenidos de una llamada a la función AcceptEx y pasa las direcciones locales y remotas a una estructura sockaddr .

Nota Esta función es una extensión específica de Microsoft para la especificación de Windows Sockets.

Sintaxis

void GetAcceptExSockaddrs(
  [in]  PVOID    lpOutputBuffer,
  [in]  DWORD    dwReceiveDataLength,
  [in]  DWORD    dwLocalAddressLength,
  [in]  DWORD    dwRemoteAddressLength,
  [out] sockaddr **LocalSockaddr,
  [out] LPINT    LocalSockaddrLength,
  [out] sockaddr **RemoteSockaddr,
  [out] LPINT    RemoteSockaddrLength
);

Parámetros

[in] lpOutputBuffer

Puntero a un búfer que recibe el primer bloque de datos enviados en una conexión resultante de una llamada AcceptEx . Debe ser el mismo parámetro lpOutputBuffer que se pasó a la función AcceptEx .

[in] dwReceiveDataLength

Número de bytes del búfer utilizado para recibir los primeros datos. Este valor debe ser igual al parámetro dwReceiveDataLength que se pasó a la función AcceptEx .

[in] dwLocalAddressLength

Número de bytes reservados para la información de dirección local. Este valor debe ser igual al parámetro dwLocalAddressLength que se pasó a la función AcceptEx .

[in] dwRemoteAddressLength

Número de bytes reservados para la información de la dirección remota. Este valor debe ser igual al parámetro dwRemoteAddressLength que se pasó a la función AcceptEx .

[out] LocalSockaddr

Puntero a la estructura sockaddr que recibe la dirección local de la conexión (la misma información que devolvería la función getsockname ). Este parámetro debe especificarse.

[out] LocalSockaddrLength

Tamaño, en bytes, de la dirección local. Este parámetro debe especificarse.

[out] RemoteSockaddr

Puntero a la estructura sockaddr que recibe la dirección remota de la conexión (la misma información que devolvería la función getpeername ). Este parámetro debe especificarse.

[out] RemoteSockaddrLength

Tamaño, en bytes, de la dirección local. Este parámetro debe especificarse.

Valor devuelto

None

Observaciones

La función GetAcceptExSockaddrs se usa exclusivamente con la función AcceptEx para analizar los primeros datos que recibe el socket en direcciones locales y remotas. La función AcceptEx devuelve información de dirección local y remota en un formato interno. Los desarrolladores de aplicaciones deben usar la función GetAcceptExSockaddrs si es necesario que las estructuras de sockaddr contengan las direcciones locales o remotas.

Nota El puntero de función para la función GetAcceptExSockaddrs debe obtenerse en tiempo de ejecución realizando una llamada a la función WSAIoctl con el SIO_GET_EXTENSION_FUNCTION_POINTER código de operación especificado. El búfer de entrada pasado a la función WSAIoctl debe contener WSAID_GETACCEPTEXSOCKADDRS, un identificador único global (GUID) cuyo valor identifica la función de extensión GetAcceptExSockaddrs . Si se ejecuta correctamente, la salida devuelta por la función WSAIoctl contiene un puntero a la función GetAcceptExSockaddrs . El GUID de WSAID_GETACCEPTEXSOCKADDRS se define en el archivo de encabezado Mswsock.h .

Windows Phone 8: esta función es compatible con las aplicaciones de Windows Phone Store en Windows Phone 8 y versiones posteriores.

Windows 8.1 y Windows Server 2012 R2: esta función es compatible con las aplicaciones de la Tienda Windows en Windows 8.1, Windows Server 2012 R2 y versiones posteriores.

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows 8.1, Windows Vista [aplicaciones de escritorio \| Aplicaciones para UWP]
Servidor mínimo compatible	Windows Server 2003 [aplicaciones de escritorio \| aplicaciones para UWP]
Plataforma de destino	Windows
Encabezado	mswsock.h (incluya Mswsock.h)
Library	Mswsock.lib
Archivo DLL	Mswsock.dll