CSADDR_INFO structure (ws2def.h)
The CSADDR_INFO structure contains Windows Sockets address information for a socket, network service, or namespace provider.
Syntax
typedef struct _CSADDR_INFO {
SOCKET_ADDRESS LocalAddr;
SOCKET_ADDRESS RemoteAddr;
INT iSocketType;
INT iProtocol;
} CSADDR_INFO, *PCSADDR_INFO, *LPCSADDR_INFO;
Members
LocalAddr
Type: SOCKET_ADDRESS
The Windows Sockets local address.
In a client application, pass this address to the bind function to obtain access to a network service.
In a network service, pass this address to the bind function so that the service is bound to the appropriate local address.
RemoteAddr
Type: SOCKET_ADDRESS
Windows Sockets remote address.
There are several uses for this remote address:
- You can use this remote address to connect to the service through the connect function. This is useful if an application performs send/receive operations that involve connection-oriented protocols.
- You can use this remote address with the sendto function when you are communicating over a connectionless (datagram) protocol. If you are using a connectionless protocol, such as UDP, sendto is typically the way you pass data to the remote system.
iSocketType
Type: INT
The type of Windows socket. Possible values for the socket type are defined in the Winsock2.h header file.
The following table lists the possible values supported for Windows Sockets 2:
| Value | Meaning |
|---|---|
|
A stream socket. This is a protocol that sends data as a stream of bytes, with no message boundaries. This socket type provides sequenced, reliable, two-way, connection-based byte streams with an OOB data transmission mechanism. This socket type uses the Transmission Control Protocol (TCP) for the Internet address family (AF_INET or AF_INET6). |
|
A datagram socket. This socket type supports datagrams, which are connectionless, unreliable buffers of a fixed (typically small) maximum length. This socket type uses the User Datagram Protocol (UDP) for the Internet address family (AF_INET or AF_INET6).
Services use recvfrom function to obtain datagrams. The listen and accept functions do not work with datagrams. |
|
A reliable message datagram socket. This socket type preserves message boundaries in data. An example of this type is the Pragmatic General Multicast (PGM) multicast protocol implementation in Windows, often referred to as reliable multicast programming. |
|
A sequenced packet stream socket. This socket type provides a pseudo-stream packet based on datagrams. |
iProtocol
Type: INT
The protocol used. The possible options for the protocol parameter are specific to the address family and socket type specified. Possible values are defined in the Winsock2.h and Wsrm.h header files.
On the Windows SDK released for Windows Vista and later, the organization of header files has changed and this parameter can be one of the values from the IPPROTO enumeration type defined in the Ws2def.h header file. Note that the Ws2def.h header file is automatically included in Winsock2.h, and should never be used directly.
The table below lists common values for the protocol although many other values are possible.
Remarks
The GetAddressByName function obtains Windows Sockets address information using CSADDR_INFO structures.
The getsockopt function called with the SO_BSP_STATE socket option retrieves a CSADDR_INFO structure for the specified socket.
Requirements
| Requirement | Value |
|---|---|
| Minimum supported client | Windows 2000 Professional [desktop apps only] |
| Minimum supported server | Windows 2000 Server [desktop apps only] |
| Header | ws2def.h (include Nspapi.h) |
See also
Feedback
Coming soon: Throughout 2024 we will be phasing out GitHub Issues as the feedback mechanism for content and replacing it with a new feedback system. For more information see: https://aka.ms/ContentUserFeedback.
Submit and view feedback for