Función getsockopt (winsock2.h)

Artículo
03/04/2024

La función getsockopt recupera una opción de socket.

Sintaxis

int WSAAPI getsockopt(
  [in]      SOCKET s,
  [in]      int    level,
  [in]      int    optname,
  [out]     char   *optval,
  [in, out] int    *optlen
);

Parámetros

[in] s

Descriptor que identifica un socket.

[in] level

Nivel en el que se define la opción. Ejemplo: SOL_SOCKET.

[in] optname

Opción de socket para la que se va a recuperar el valor. Ejemplo: SO_ACCEPTCONN. El valor optname debe ser una opción de socket definida dentro del nivel especificado o el comportamiento no está definido.

[out] optval

Puntero al búfer en el que se va a devolver el valor de la opción solicitada.

[in, out] optlen

Puntero al tamaño, en bytes, del búfer optval .

Valor devuelto

Si no se produce ningún error, getsockopt devuelve cero. De lo contrario, se devuelve un valor de SOCKET_ERROR y se puede recuperar un código de error específico mediante una llamada a WSAGetLastError.

Código de error	Significado
WSANOTINITIALISED	Debe producirse una llamada WSAStartup correcta antes de usar esta función.
WSAENETDOWN	Nota Error en el subsistema de red.
WSAEFAULT	Uno de los parámetros optval o optlen no es una parte válida del espacio de direcciones del usuario o el parámetro optlen es demasiado pequeño.
WSAEINPROGRESS	Una llamada de Bloqueo de Windows Sockets 1.1 está en curso o el proveedor de servicios sigue procesando una función de devolución de llamada.
WSAEINVAL	El parámetro level es desconocido o no válido.
WSAENOPROTOOPT	La opción es desconocida o no admitida por la familia de protocolos indicada.
WSAENOTSOCK	El descriptor no es un socket.

Comentarios

La función getsockopt recupera el valor actual de una opción de socket asociada a un socket de cualquier tipo, en cualquier estado y almacena el resultado en optval. Las opciones pueden existir en varios niveles de protocolo, pero siempre están presentes en el nivel de socket superior. Las opciones afectan a las operaciones de socket, como el enrutamiento de paquetes y la transferencia de datos OOB.

El valor asociado a la opción seleccionada se devuelve en la opción optval del búfer. El entero al que apunta optlen debe contener originalmente el tamaño de este búfer; en la devolución, se establecerá en el tamaño del valor devuelto. Por SO_LINGER, este será el tamaño de una estructura LINGER . Para la mayoría de las demás opciones, será el tamaño de un entero.

La aplicación es responsable de asignar cualquier espacio de memoria al que apunte directa o indirectamente cualquiera de los parámetros especificados.

Si la opción nunca se estableció con setsockopt, getsockopt devuelve el valor predeterminado de la opción.

Se admiten las siguientes opciones para getsockopt. La columna Tipo identifica el tipo de datos direccionado por optval.

Para obtener más información sobre las opciones de socket, consulte Opciones de socket.

La siguiente tabla de valor para el parámetro optname es válida cuando el parámetro level se establece en SOL_SOCKET.

Valor	Tipo	Significado
SO_ACCEPTCONN	BOOL	El socket se encuentra a la escucha.
SO_BROADCAST	BOOL	El socket está configurado para la transmisión y recepción de mensajes de difusión.
SO_BSP_STATE	CSADDR_INFO	Devuelve la dirección local, el puerto local, la dirección remota, el puerto remoto, el tipo de socket y el protocolo usados por un socket.
SO_CONDITIONAL_ACCEPT	BOOL	Devuelve el estado de socket actual, ya sea desde una llamada anterior a setsockopt o el valor predeterminado del sistema.
SO_CONNECT_TIME	DWORD	Devuelve el número de segundos que se ha conectado un socket. Esta opción de socket solo es válida para los protocolos orientados a la conexión.
SO_DEBUG	BOOL	La depuración está habilitada.
SO_DONTLINGER	BOOL	Si es TRUE, la opción SO_LINGER está deshabilitada.
SO_DONTROUTE	BOOL	El enrutamiento está deshabilitado. Establecer esto se realiza correctamente, pero se omite en AF_INET sockets; produce un error en AF_INET6 sockets con WSAENOPROTOOPT. Esta opción no se admite en sockets ATM.
SO_ERROR	int	Recupera el estado del error y borra.
SO_EXCLUSIVEADDRUSE	BOOL	Impide que cualquier otro socket se enlace a la misma dirección y puerto. Esta opción debe establecerse antes de llamar a la función bind .
SO_GROUP_ID	GROUP	Reservado.
SO_GROUP_PRIORITY	int	Reservado.
SO_KEEPALIVE	BOOL	Se envía el mantenimiento de conexiones abiertas. No se admite en sockets ATM.
SO_LINGER	Estructura DE LA LENCE	Devuelve las opciones de persistencia actuales.
SO_MAX_MSG_SIZE	unsigned int	Tamaño máximo de un mensaje para los tipos de socket orientados a mensajes (por ejemplo, SOCK_DGRAM). No tiene ningún significado para los sockets orientados a flujos.
SO_OOBINLINE	BOOL	Los datos OOB se reciben en el flujo de datos normal. (Consulte la sección Rutinas de bloqueo de Windows Sockets 1.1 y EINPROGRESS para obtener una explicación de este tema).
SO_PORT_SCALABILITY	BOOL	Permite la escalabilidad del puerto local para un socket al permitir que la asignación de puertos se maximice asignando puertos comodín varias veces para diferentes pares de puertos de direcciones locales en un equipo local.
SO_PROTOCOL_INFO	WSAPROTOCOL_INFO	Descripción de la información del protocolo para el protocolo enlazado a este socket.
SO_RCVBUF	int	Espacio total de búfer por socket reservado para las recepción. Esto no está relacionado con SO_MAX_MSG_SIZE y no se corresponde necesariamente con el tamaño de la ventana de recepción TCP.
SO_REUSEADDR	BOOL	El socket se puede enlazar a una dirección que ya está en uso. No es aplicable a los sockets ATM.
SO_SNDBUF	int	Espacio total de búferes por socket reservado para envíos. Esto no está relacionado con SO_MAX_MSG_SIZE y no se corresponde necesariamente con el tamaño de una ventana de envío TCP.
SO_TYPE	int	Tipo del socket (por ejemplo, SOCK_STREAM).
PVD_CONFIG	Dependiente del proveedor de servicios	Objeto de estructura de datos opaco del proveedor de servicios asociado a sockets. Este objeto almacena la información de configuración actual del proveedor de servicios. El formato exacto de esta estructura de datos es específico del proveedor de servicios.

Nivel = IPPROTO_TCP

Consulte TCP_NODELAY en IPPROTO_TCPopciones de socket. Consulte también ese tema para obtener información más completa y detallada sobre las opciones de socket paraIPPROTO_TCPde nivel = .

La siguiente tabla de valor para el parámetro optname es válida cuando el parámetro level se establece en NSPROTO_IPX.

Nota Windows NT admite todas las opciones de IPX. Windows Me, Windows 98 y Windows 95 solo admiten las siguientes opciones:

IPX_PTYPE

IPX_FILTERPTYPE

IPX_DSTYPE

IPX_RECVHDR

IPX_MAXSIZE

IPX_ADDRESS

Valor	Tipo	Significado
IPX_PTYPE	int	Recupera el tipo de paquete IPX.
IPX_FILTERPTYPE	int	Recupera el tipo de paquete de filtro de recepción.
IPX_DSTYPE	int	Obtiene el valor del campo de flujo de datos en el encabezado SPX en cada paquete enviado.
IPX_EXTENDED_ADDRESS	BOOL	Descubre si el direccionamiento extendido está habilitado.
IPX_RECVHDR	BOOL	Descubre si el encabezado de protocolo se envía en todos los encabezados de recepción.
IPX_MAXSIZE	int	Obtiene el tamaño máximo de datos que se puede enviar.
IPX_ADDRESS	estructura de IPX_ADDRESS_DATA	Obtiene información sobre un adaptador específico al que está enlazado IPX. La numeración del adaptador es cero base. El miembro adapternum se rellena al devolver.
IPX_GETNETINFO	estructura de IPX_NETNUM_DATA	Obtiene información sobre un número de red IPX específico. Si no está disponible en la memoria caché, usa RIP para obtener información.
IPX_GETNETINFO_NORIP	estructura de IPX_NETNUM_DATA	Obtiene información sobre un número de red IPX específico. Si no está disponible en la memoria caché, no usará RIP para obtener información y devuelve un error.
IPX_SPXGETCONNECTIONSTATUS	estructura de IPX_SPXCONNSTATUS_DATA	Recupera información sobre un socket SPX conectado.
IPX_ADDRESS_NOTIFY	estructura de IPX_ADDRESS_DATA	Recupera la notificación de estado cuando se producen cambios en un adaptador al que está enlazado IPX.
IPX_MAX_ADAPTER_NUM	int	Recupera el número máximo de adaptadores presentes, numerados como cero base.
IPX_RERIPNETNUMBER	estructura de IPX_NETNUM_DATA	De forma similar a IPX_GETNETINFO, pero obliga a IPX a usar RIP para la resolución, incluso si la información de red está en la memoria caché local.
IPX_IMMEDIATESPXACK	BOOL	Dirige las conexiones SPX que no se retrasan antes de enviar una ACK. Las aplicaciones sin tráfico de ida y vuelta deben establecer esto en TRUE para aumentar el rendimiento.
TCP_MAXSEG	int	Recibe el tamaño máximo del segmento TCP. Compatible con Windows 10 y versiones más recientes.

En la tabla siguiente se muestra el valor de optname que representa las opciones de socket BSD que no son compatibles con la función getsockopt .

Valor	Tipo	Significado
SO_RCVLOWAT	int	Recibe una marca de agua baja.
SO_RCVTIMEO	int	Recibe el tiempo de espera.
SO_SNDLOWAT	int	Envía una marca de agua baja.
SO_SNDTIMEO	int	Envía el tiempo de espera.
TCP_MAXSEG	int	Recibe el tamaño máximo del segmento TCP. No se admite en versiones anteriores a Windows 10.

Nota Cuando se usa la función recv , si no llega ningún dato durante el período especificado en SO_RCVTIMEO, se completa la función recv . En versiones de Windows anteriores a Windows 2000, los datos recibidos posteriormente producirán un error con WSAETIMEDOUT. En Windows 2000 y versiones posteriores, si no llega ningún dato dentro del período especificado en SO_RCVTIMEO, la función recv devuelve WSAETIMEDOUT y, si se reciben los datos, recv devuelve SUCCESS.

Al llamar a getsockopt con una opción no admitida, se devolverá un código de error de WSAENOPROTOOPT de WSAGetLastError.

A continuación se muestra información más detallada sobre algunas de las opciones de socket para el parámetro optname admitido por la función getockopt .

SO_CONNECT_TIME: Esta opción devuelve el número de segundos que se ha conectado un socket. Esta opción solo es válida para protocolos orientados a conexiones.
La opción SO_CONNECT_TIME se puede usar con la función getockopt para comprobar si se ha establecido una conexión. Esta opción también se puede usar mientras una llamada de función ConnectEx está en curso. Si se establece una conexión, la opción SO_CONNECT_TIME puede determinar cuánto tiempo se ha establecido la conexión. Si el socket no está conectado, getsockopt devuelve SOCKET_ERROR. Comprobar una conexión como esta es necesaria para ver si las conexiones que se han establecido durante un tiempo, sin enviar datos. Se recomienda que las aplicaciones finalicen estas conexiones.
SO_DEBUG: Nota Se recomienda a los proveedores de servicios de Windows Sockets (pero no necesarios) proporcionar información de depuración de salida si una aplicación establece la opción SO_DEBUG. El mecanismo para generar la información de depuración y el formulario que toma están fuera del ámbito de este documento.
SO_ERROR: La opción SO_ERROR devuelve y restablece el código de error basado en socket, que es diferente del código de error basado en subprocesos que se controla mediante las llamadas de función WSAGetLastError y WSASetLastError . Una llamada correcta mediante el socket no restablece el código de error basado en socket devuelto por la opción SO_ERROR.
SO_EXCLUSIVEADDRUSE: Impide que cualquier otro socket se enlace a la misma dirección y puerto. Esta opción debe establecerse antes de llamar a la función bind . Consulte la referencia de SO_EXCLUSIVEADDRUSE para obtener más información.
SO_GROUP_ID: Nota Esta opción está reservada. Esta opción también es exclusiva de getockopt; el valor debe ser NULL.
SO_GROUP_PRIORITY: Esta opción está reservada. La prioridad de grupo indica la prioridad del socket especificado en relación con otros sockets del grupo de sockets. Los valores son enteros no negativos, con cero correspondiente a la prioridad más alta. Los valores de prioridad representan una sugerencia al proveedor de servicios subyacente sobre cómo se deben asignar recursos potencialmente escasos. Por ejemplo, cada vez que dos o más sockets están listos para transmitir datos, el socket de prioridad más alto (valor más bajo para SO_GROUP_PRIORITY) se debe atender primero, con el resto con servicio a su vez según sus prioridades relativas.
El código de error WSAENOPROTOOPT se indica para sockets que no son de grupo o para proveedores de servicios que no admiten sockets de grupo.
SO_KEEPALIVE: Una aplicación puede solicitar que un proveedor de servicios TCP/IP habilite el uso de paquetes de mantenimiento activo en las conexiones TCP activando la opción de socket SO_KEEPALIVE. Esta opción consulta el valor actual de la opción keep-alive en un socket. Un proveedor de Windows Sockets no necesita admitir el uso de keep-alive: si lo hace, la semántica precisa es específica de la implementación, pero debe cumplir la sección 4.2.3.6 en los Requisitos para hosts de Internet: capas de comunicación especificadas en RFC 1122 disponibles en el sitio web de IETF. Si se quita una conexión como resultado de keep-alives, el código de error WSAENETRESET se devuelve a cualquier llamada en curso en el socket y se producirá un error en las llamadas posteriores con WSAENOTCONN. SO_KEEPALIVE no se admite en sockets ATM, y las solicitudes para habilitar el uso de paquetes de mantenimiento activo en un socket ATM producen un error devuelto por el socket.
SO_LINGER: SO_LINGER controla la acción realizada cuando los datos sin enviar se ponen en cola en un socket y se realiza un closesocket . Consulte closesocket para obtener una descripción de la forma en que la configuración de SO_LINGER afecta a la semántica de closesocket. La aplicación obtiene el comportamiento actual recuperando una estructura LINGER (a la que apunta el parámetro optval ).
SO_MAX_MSG_SIZE: Se trata de una opción de socket get-only que indica el tamaño máximo de salida (envío) de un mensaje para los tipos de socket orientados a mensajes (por ejemplo, SOCK_DGRAM) implementados por un proveedor de servicios determinado. No tiene ningún significado para los sockets orientados a flujos de bytes. No hay ninguna disposición para averiguar el tamaño máximo del mensaje entrante.
SO_PROTOCOL_INFO: Se trata de una opción de solo obtención que proporciona la estructura de WSAPROTOCOL_INFO asociada a este socket. Consulte WSAEnumProtocols para obtener más información sobre esta estructura.
SO_SNDBUF: Cuando una implementación de Windows Sockets admite las opciones de SO_RCVBUF y SO_SNDBUF, una aplicación puede solicitar diferentes tamaños de búfer (mayores o más pequeños). La llamada a setsockopt puede realizarse correctamente incluso si la implementación no proporcionó toda la cantidad solicitada. Una aplicación debe llamar a esta función con la misma opción para comprobar el tamaño del búfer proporcionado realmente.
SO_REUSEADDR: De forma predeterminada, un socket no se puede enlazar (consulte el enlace) a una dirección local que ya está en uso. Sin embargo, en ocasiones, puede ser necesario reutilizar una dirección de esta manera. Dado que cada conexión se identifica de forma única mediante la combinación de direcciones locales y remotas, no hay ningún problema con tener dos sockets enlazados a la misma dirección local siempre que las direcciones remotas sean diferentes. Para informar al proveedor de Windows Sockets de que no se debe denegar un enlace en un socket porque la dirección deseada ya está en uso por otro socket, la aplicación debe establecer la opción de socket SO_REUSEADDR para el socket antes de emitir el enlace. Tenga en cuenta que la opción solo se interpreta en el momento del enlace: por lo tanto, no es necesario (pero inofensivo) establecer la opción en un socket que no se va a enlazar a una dirección existente y establecer o restablecer la opción después de que el enlace no tenga ningún efecto en este o en cualquier otro socket. SO_REUSEADDR no es aplicable a los sockets ATM, y aunque las solicitudes de reutilización y dirección no dan lugar a un error, no tienen ningún efecto en cuando un socket ATM está en uso.
PVD_CONFIG: Esta opción recupera un objeto de estructura de datos opaco del proveedor de servicios asociado a sockets. Este objeto almacena la información de configuración actual del proveedor de servicios. El formato exacto de esta estructura de datos es específico del proveedor de servicios.
TCP_NODELAY: La opción TCP_NODELAY es específica de los proveedores de servicios TCP/IP. El algoritmo nagle está deshabilitado si la opción TCP_NODELAY está habilitada (y viceversa). El algoritmo nagle (descrito en RFC 896) es muy eficaz para reducir el número de paquetes pequeños enviados por un host. El proceso implica almacenar en búfer los datos de envío cuando ya hay datos no reconocidos en el vuelo o el almacenamiento en búfer envían datos hasta que se pueda enviar un paquete de tamaño completo. Se recomienda encarecidamente que las implementaciones de Windows Sockets habiliten el algoritmo nagle de forma predeterminada porque, para la gran mayoría de los protocolos de aplicación, el algoritmo nagle puede ofrecer mejoras de rendimiento significativas. Sin embargo, para algunas aplicaciones, este algoritmo puede impedir el rendimiento y setockopt con la misma opción se puede usar para desactivarlo. Estas son aplicaciones en las que se envían muchos mensajes pequeños y se mantienen los retrasos de tiempo entre los mensajes.

Nota Al emitir una llamada de Winsock de bloqueo como getockopt, Winsock puede que tenga que esperar un evento de red antes de que se pueda completar la llamada. Winsock realiza una espera alertable en esta situación, que se puede interrumpir mediante una llamada de procedimiento asincrónica (APC) programada en el mismo subproceso. La emisión de otra llamada winsock de bloqueo dentro de un APC que interrumpió una llamada de Winsock de bloqueo en curso en el mismo subproceso provocará un comportamiento indefinido y los clientes winsock nunca deben intentarlo.

Código de ejemplo

En el ejemplo de código siguiente se muestra el uso de la función getockopt .

#include <stdio.h>
#include "winsock2.h"
#include <windows.h>

void main() {

  //---------------------------------------
  // Declare variables
  WSADATA wsaData;
  SOCKET ListenSocket;
  sockaddr_in service;

  //---------------------------------------
  // Initialize Winsock
  int iResult = WSAStartup( MAKEWORD(2,2), &wsaData );
  if( iResult != NO_ERROR )
    printf("Error at WSAStartup\n");

  //---------------------------------------
  // Create a listening socket
  ListenSocket = socket( AF_INET, SOCK_STREAM, IPPROTO_TCP );
  if (ListenSocket == INVALID_SOCKET) {
    printf("Error at socket()\n");
    WSACleanup();
    return;
  }

  //---------------------------------------
  // Bind the socket to the local IP address
  // and port 27015
  hostent* thisHost;
  char* ip;
  u_short port;
  port = 27015;
  thisHost = gethostbyname("");
  ip = inet_ntoa (*(struct in_addr *)*thisHost->h_addr_list);

  service.sin_family = AF_INET;
  service.sin_addr.s_addr = inet_addr(ip);
  service.sin_port = htons(port);
 
  if ( bind( ListenSocket,(SOCKADDR*) &service, sizeof(service) )  == SOCKET_ERROR ) {
    printf("bind failed\n");
    closesocket(ListenSocket);
    return;
  }

  //---------------------------------------
  // Initialize variables and call getsockopt. 
  // The SO_ACCEPTCONN parameter is a socket option 
  // that tells the function to check whether the 
  // socket has been put in listening mode or not. 
  // The various socket options return different
  // information about the socket. This call should
  // return 0 to the optVal parameter, since the socket
  // is not in listening mode.
  int optVal;
  int optLen = sizeof(int);

  if (getsockopt(ListenSocket, 
    SOL_SOCKET, 
    SO_ACCEPTCONN, 
    (char*)&optVal, 
    &optLen) != SOCKET_ERROR)
    printf("SockOpt Value: %ld\n", optVal);

  //---------------------------------------
  // Put the listening socket in listening mode.
  if (listen( ListenSocket, 100 ) == SOCKET_ERROR) {
    printf("error listening\n");
  } 

  //---------------------------------------
  // Call getsockopt again to verify that 
  // the socket is in listening mode.
  if (getsockopt(ListenSocket, 
    SOL_SOCKET, 
    SO_ACCEPTCONN, 
    (char*)&optVal, 
    &optLen) != SOCKET_ERROR)
    printf("SockOpt Value: %ld\n", optVal);

  WSACleanup();
  return;
}

Notas para sockets irDA

El archivo de encabezado Af_irda.h debe incluirse explícitamente.
Windows devuelve WSAENETDOWN para indicar que el controlador transceptor subyacente no se pudo inicializar con la pila de protocolos IrDA.
IrDA admite varias opciones de socket especiales:

Valor Tipo Significado

IRLMP_ENUMDEVICES *DEVICELIST Describe los dispositivos en el intervalo.

IRLMP_IAS_QUERY *IAS_QUERY Recuperar atributos de IAS.

Valor	Tipo	Significado
IRLMP_ENUMDEVICES	*DEVICELIST	Describe los dispositivos en el intervalo.
IRLMP_IAS_QUERY	*IAS_QUERY	Recuperar atributos de IAS.

Antes de que se pueda iniciar una conexión de socket IrDA, se debe obtener una dirección de dispositivo realizando una llamada de función getockopt(,,IRLMP_ENUMDEVICES,,), que devuelve una lista de todos los dispositivos IrDA disponibles. Una dirección de dispositivo devuelta desde la llamada de función se copia en una estructura de SOCKADDR_IRDA , que a su vez se usa en una llamada posterior a la llamada de función connect .

La detección se puede realizar de dos maneras:

En primer lugar, realizar una llamada de función getockopt con la opción IRLMP_ENUMDEVICES hace que se ejecute una única detección en cada adaptador inactivo. La lista de dispositivos detectados y dispositivos almacenados en caché (en adaptadores activos) se devuelve inmediatamente.

En el código siguiente se muestra este enfoque.

#include <winsock2.h>
#include <ws2tcpip.h>
#include <af_irda.h>
#include <stdio.h>
#include <windows.h>

// link with Ws2_32.lib

int __cdecl main()
{

    //-----------------------------------------
    // Declare and initialize variables
    WSADATA wsaData;

    int iResult;
    int i;
    DWORD dwError;

    SOCKET Sock = INVALID_SOCKET;

#define DEVICE_LIST_LEN    10


    SOCKADDR_IRDA DestSockAddr = { AF_IRDA, 0, 0, 0, 0, "SampleIrDAService" };

    unsigned char DevListBuff[sizeof (DEVICELIST) -
                              sizeof (IRDA_DEVICE_INFO) +
                              (sizeof (IRDA_DEVICE_INFO) * DEVICE_LIST_LEN)];

    int DevListLen = sizeof (DevListBuff);
    PDEVICELIST pDevList;

    pDevList = (PDEVICELIST) & DevListBuff;

    // Initialize Winsock
    iResult = WSAStartup(MAKEWORD(2, 2), &wsaData);
    if (iResult != 0) {
        printf("WSAStartup failed: %d\n", iResult);
        return 1;
    }

    Sock = socket(AF_IRDA, SOCK_STREAM, 0);
    if (Sock == INVALID_SOCKET) {
        dwError = WSAGetLastError();
        printf
            ("socket failed trying to create an AF_IRDA socket with error %d\n",
             dwError);

        if (dwError == WSAEAFNOSUPPORT) {
            printf("Check that the local computer has an infrared device\n");
            printf
                ("and a device driver is installed for the infrared device\n");
        }
        WSACleanup();
        return 1;
    }
    // Sock is not in connected state
    iResult = getsockopt(Sock, SOL_IRLMP, IRLMP_ENUMDEVICES,
                         (char *) pDevList, &DevListLen);
    if (iResult == SOCKET_ERROR) {
        printf("getsockopt failed with error %d\n", WSAGetLastError());
        WSACleanup();
        return 1;
    }

    if (pDevList->numDevice == 0) {
        // no devices discovered or cached
        // not a bad idea to run a couple of times
        printf("No IRDA devices were discovered or cached\n");
    } else {
        // one per discovered device
        for (i = 0; i < (int) pDevList->numDevice; i++) {
            // typedef struct _IRDA_DEVICE_INFO
            // {
            //     u_char    irdaDeviceID[4];
            //     char      irdaDeviceName[22];
            //     u_char    irdaDeviceHints1;
            //     u_char    irdaDeviceHints2;
            //     u_char    irdaCharSet;
            // } _IRDA_DEVICE_INFO;

            // pDevList->Device[i]. see _IRDA_DEVICE_INFO for fields
            // display the device names and let the user select one
        }
    }

    // assume the user selected the first device [0]
    memcpy(&DestSockAddr.irdaDeviceID[0], &pDevList->Device[0].irdaDeviceID[0],
           4);

    iResult = connect(Sock, (const struct sockaddr *) &DestSockAddr,
                      sizeof (SOCKADDR_IRDA));
    if (iResult == SOCKET_ERROR) {
        printf("connect failed with error %d\n", WSAGetLastError());
    } else
        printf("connect to first IRDA device was successful\n");

    WSACleanup();
    return 0;
}

El segundo enfoque para realizar la detección de direcciones de dispositivo IrDA es realizar una detección diferida; en este enfoque, la aplicación no se notifica hasta que la lista de dispositivos detectados cambie de la última detección ejecutada por la pila.

La estructura DEVICELIST que se muestra en la columna Tipo de la tabla anterior es una matriz extensible de descripciones de dispositivos. IrDA rellena tantas descripciones de dispositivo como pueda caber en el búfer especificado. La descripción del dispositivo consta de un identificador de dispositivo necesario para formar una estructura de sockaddr_irda y una cadena que describe el dispositivo.

La estructura de IAS_QUERY que se muestra en la columna Tipo de la tabla anterior se usa para recuperar un único atributo de una sola clase de la base de datos IAS de un dispositivo del mismo nivel. La aplicación especifica el dispositivo y la clase que se van a consultar y el atributo y el tipo de atributo. Tenga en cuenta que el dispositivo se habría obtenido anteriormente mediante una llamada a getsockopt(IRLMP_ENUMDEVICES). Se espera que la aplicación asigne un búfer, del tamaño necesario, para los parámetros devueltos.

Muchas opciones de socket de nivel no son significativas para IrDA; solo se admiten SO_LINGER y SO_DONTLINGER específicamente.

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	winsock2.h (incluya Winsock2.h)
Library	Ws2_32.lib
Archivo DLL	Ws2_32.dll