This topic has not yet been rated - Rate this topic

DsValidateSubnetName function

The DsValidateSubnetName function validates a subnet name in the form xxx.xxx.xxx.xxx/YY. The Xxx.xxx.xxx.xxx portion must be a valid IP address. Yy must be the number of leftmost significant bits included in the mask. All bits of the IP address that are not covered by the mask must be specified as zero.

Syntax

C++


DWORD DsValidateSubnetName(
  _In_  LPCTSTR SubnetName
);

Parameters

SubnetName [in]: Pointer to a null-terminated string that specifies the name of the subnet to validate.

Return value

If the function returns account information, the return value is NO_ERROR.

If the function fails, the return value is the following error code.

Return code	Description
ERROR_INVALID_NAME	Subnet name is not valid.

Requirements

Minimum supported client	Windows 2000 Professional [desktop apps only]
Minimum supported server	Windows 2000 Server [desktop apps only]
Header	Dsgetdc.h
Library	Netapi32.lib
DLL	Netapi32.dll
Unicode and ANSI names	DsValidateSubnetNameW (Unicode) and DsValidateSubnetNameA (ANSI)

Community Additions