WSHGetSockaddrType

INT
    WSHGetSockaddrType(
        IN PSOCKADDR  Sockaddr,
        IN DWORD  SockaddrLength,
        OUT PSOCKADDR_INFO  SockaddrInfo
        );

WSHGetSockaddrType parses a socket address and returns information about it to Windows Sockets.

Parameters

Sockaddr

Points to the SOCKADDR structure to be evaluated.

SockaddrLength

Specifies the length, in bytes, of the SOCKADDR structure at Sockaddr.

SockaddrInfo

Points to a buffer in which the helper DLL returns information about the socket address, formatted as a SOCKADDR_INFO structure.

Return Value

WSHGetSockaddrType returns zero if the given socket address is valid for the address family supported by this helper DLL. Otherwise, it returns a Windows Sockets error code.

Comments

Windows Sockets calls WSHGetSockaddrType when it needs information about a SOCKADDR. The helper DLL evaluates both the machine address and endpoint portions of the SOCKADDR. The machine-address portion specifies a particular machine, for example, the IP address in an internet address. The endpoint specifies a particular service on a machine, corresponding to the port number in an internet address.

The SOCKADDR_INFO structure is defined as follows:

typedef struct _SOCKADDR_INFO {
    SOCKADDR_ADDRESS_INFO AddressInfo;
    SOCKADDR_ENDPOINT_INFO EndpointInfo;
} SOCKADDR_INFO, *PSOCKADDR_INFO;
 

SOCKADDR_ADDRESS_INFO is an enumerated type, with the following possible values:

SockaddrAddressInfoNormal

The address portion of the SOCKADDR has no unusual characteristics.

SockaddrAddressInfoWildcard

The address portion of the SOCKADDR is a “wildcard,” meaning that it does not specify a particular address. For example, this corresponds to INADDR_ANY (0.0.0.0) for IP addresses, which an application passes to bind when it has no particular requirements for the IP address used for a socket.

SockaddrAddressInfoBroadcast

The address portion of the SOCKADDR refers to the address family’s broadcast address. For example, in IP addresses, this is INADDR_BROADCAST (255.255.255.255).

SockaddrAddressInfoLoopback

The address portion of the SOCKADDR refers to the address family’s loopback address. For example, in internet addresses, this is INADDR_LOOPBACK (127.0.0.1).

SOCKADDR_ENDPOINT_INFO also is an enumerated type, with the following possible values:

SockaddrEndpointInfoNormal 

The endpoint portion of the SOCKADDR has no unusual characteristics.

SockaddrEndpointInfoWildcard 

The endpoint portion of the SOCKADDR is a wildcard, meaning that it could refer to any endpoint. An application, typically a client, can pass a wildcard endpoint to bind when it has no particular requirements for the endpoint assigned. For example, in IP addresses, a port set to zero is a wildcard endpoint.

SockaddrEndpointInfoReserved

The endpoint of the SOCKADDR is reserved, meaning that special privilege is required to bind to it. For example, in internet addresses, a port with a value less than IPPORT_RESERVED (1024) is a reserved endpoint.