sockaddr
La estructura de sockaddr varía en función del protocolo seleccionado. Excepto para el parámetro sin*_family , el contenido de sockaddr se expresa en orden de bytes de red.
Las funciones winsock que usan sockaddr no se interpretan estrictamente como punteros a una estructura de sockaddr. La estructura se interpreta de forma diferente en el contexto de diferentes familias de direcciones. Los únicos requisitos son que el primer u_short es la familia de direcciones y el tamaño total del búfer de memoria en bytes es namelen.
La estructura de SOCKADDR_STORAGE también almacena la información de dirección del socket y la estructura es lo suficientemente grande como para almacenar información de direcciones IPv4 o IPv6. El uso de la estructura SOCKADDR_STORAGE promueve la independencia de la familia de protocolos y la versión de protocolo, y simplifica el desarrollo. Se recomienda usar la estructura SOCKADDR_STORAGE en lugar de la estructura sockaddr. La estructura de SOCKADDR_STORAGE se admite en Windows Server 2003 y versiones posteriores.
La estructura sockaddr y las estructuras de sockaddr_in siguientes se usan con IPv4. Otros protocolos usan estructuras similares.
struct sockaddr {
ushort sa_family;
char sa_data[14];
};
struct sockaddr_in {
short sin_family;
u_short sin_port;
struct in_addr sin_addr;
char sin_zero[8];
};
Las estructuras sockaddr_in6 y sockaddr_in6_old siguientes se usan con IPv6.
struct sockaddr_in6 {
short sin6_family;
u_short sin6_port;
u_long sin6_flowinfo;
struct in6_addr sin6_addr;
u_long sin6_scope_id;
};
typedef struct sockaddr_in6 SOCKADDR_IN6;
typedef struct sockaddr_in6 *PSOCKADDR_IN6;
typedef struct sockaddr_in6 FAR *LPSOCKADDR_IN6;
struct sockaddr_in6_old {
short sin6_family;
u_short sin6_port;
u_long sin6_flowinfo;
struct in6_addr sin6_addr;
};
En el Kit de desarrollo de software (SDK) de Microsoft Windows publicado para Windows Vista y versiones posteriores, las etiquetas typedef y soCKADDR y SOCKADDR_IN se definen para las estructuras sockaddr y sockaddr_in de la siguiente manera:
typedef struct sockaddr {
#if (_WIN32_WINNT < 0x0600)
u_short sa_family;
#else
ADDRESS_FAMILY sa_family;
#endif //(_WIN32_WINNT < 0x0600)
CHAR sa_data[14];
} SOCKADDR, *PSOCKADDR, FAR *LPSOCKADDR;
typedef struct sockaddr_in {
#if(_WIN32_WINNT < 0x0600)
short sin_family;
#else //(_WIN32_WINNT < 0x0600)
ADDRESS_FAMILY sin_family;
#endif //(_WIN32_WINNT < 0x0600)
USHORT sin_port;
IN_ADDR sin_addr;
CHAR sin_zero[8];
} SOCKADDR_IN, *PSOCKADDR_IN;
En windows SDK publicado para Windows Vista y versiones posteriores, la organización de archivos de encabezado ha cambiado y las estructuras de sockaddr y sockaddr_in se definen en el archivo de encabezado Ws2def.h , no en el archivo de encabezado Winsock2.h . El archivo de encabezado Ws2def.h se incluye automáticamente en el archivo de encabezado Winsock2.h . La estructura sockaddr_in6 se define en el archivo de encabezado Ws2ipdef.h , no en el archivo de encabezado Ws2tcpip.h . El archivo de encabezado Ws2ipdef.h se incluye automáticamente en el archivo de encabezado Ws2tcpip.h . Los archivos de encabezado Ws2def.h y Ws2ipdef.h nunca deben usarse directamente.
Código de ejemplo
En el ejemplo siguiente se muestra el uso de la estructura sockaddr .
// Declare variables
SOCKET ListenSocket;
struct sockaddr_in saServer;
hostent* localHost;
char* localIP;
// Create a listening socket
ListenSocket = socket(AF_INET, SOCK_STREAM, IPPROTO_TCP);
// Get the local host information
localHost = gethostbyname("");
localIP = inet_ntoa (*(struct in_addr *)*localHost->h_addr_list);
// Set up the sockaddr structure
saServer.sin_family = AF_INET;
saServer.sin_addr.s_addr = inet_addr(localIP);
saServer.sin_port = htons(5150);
// Bind the listening socket using the
// information in the sockaddr structure
bind( ListenSocket,(SOCKADDR*) &saServer, sizeof(saServer) );
Consulte también