Directory Services

DsValidateSubnetName

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.

DWORD DsValidateSubnetName(
  LPCTSTR SubnetName
);

Parameters

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

Return Values

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

Client: Included in Windows XP and Windows 2000 Professional.
Server: Included in Windows Server 2003 and Windows 2000 Server.
Unicode: Implemented as Unicode and ANSI versions.
Header: Declared in Dsgetdc.h.
Library: Use Netapi32.lib.

See Also

Directory Service Functions, DsGetDcName, DsGetSiteName