sockaddr
Структура sockaddr зависит от выбранного протокола. За исключением параметра sin*_family , содержимое sockaddr выражается в сетевом порядке байтов.
Функции Winsock, использующие sockaddr, не интерпретируются строго как указатели на структуру sockaddr. Структура интерпретируется по-разному в контексте различных семейств адресов. Единственными требованиями являются то, что первым u_short является семейство адресов, а общий размер буфера памяти в байтах — namelen.
В структуре SOCKADDR_STORAGE также хранятся сведения об адресе сокета, а структура достаточно велика для хранения сведений об адресах IPv4 или IPv6. Использование структуры SOCKADDR_STORAGE способствует независимости семейства протоколов и версий протокола, а также упрощает разработку. Рекомендуется использовать структуру SOCKADDR_STORAGE вместо структуры sockaddr. Структура SOCKADDR_STORAGE поддерживается в Windows Server 2003 и более поздних версиях.
Приведенная ниже структура sockaddr и структуры sockaddr_in используются с IPv4. Другие протоколы используют аналогичные структуры.
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];
};
Приведенные ниже структуры sockaddr_in6 и sockaddr_in6_old используются с 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;
};
В пакете средств разработки программного обеспечения Microsoft Windows (SDK), выпущенном для Windows Vista и более поздних версий, теги typedef SOCKADDR и SOCKADDR_IN определяются для структур sockaddr и sockaddr_in следующим образом:
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;
В windows SDK, выпущенном для Windows Vista и более поздних версий, организация файлов заголовков изменилась, а структуры sockaddr и sockaddr_in определяются в файле заголовка Ws2def.h , а не в файле заголовка Winsock2.h . Файл заголовка Ws2def.h автоматически включается в файл заголовка Winsock2.h . Структура sockaddr_in6 определяется в файле заголовка Ws2ipdef.h , а не в файле заголовка Ws2tcpip.h . Файл заголовка Ws2ipdef.h автоматически включается в файл заголовка Ws2tcpip.h . Файлы заголовков Ws2def.h и Ws2ipdef.h никогда не следует использовать напрямую.
В следующем примере показано использование структуры 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) );