CInternetServer::IsAddressNull Method  
 
BOOL IsAddressNull(
  LPCTSTR lpszAddress  
);
BOOL IsAddressNull(
  LPINTERNET_ADDRESS lpAddress  
);

The IsAddressNull method determines if the IP address is null.

Parameters

lpszAddress
A string that specifies the IP address.
lpAddress
A pointer to an INTERNET_ADDRESS structure that specifies the IP address.

Return Value

If the method succeeds and the IP address is null, or the parameter is a NULL pointer, the return value is non-zero. If the method fails or the address is not null, the return value is zero. If the address family is not supported, the last error code will be updated. If the address is valid but not null, the last error code will be set to NO_ERROR.

Remarks

A null IP address is one where all bits for the address (32 bits for IPv4 or 128 bits for IPv6) are zero. This is a special address that is typically used when creating a passive socket that should listen for connections on all available network interfaces.

Requirements

Minimum Desktop Platform: Windows 7 Service Pack 1
Minimum Server Platform: Windows Server 2008 R2 Service Pack 1
Header File: cswsock11.h
Import Library: cswskv11.lib

See Also

GetAddress, IsAddressRoutable, INTERNET_ADDRESS