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.

ERROR_INVALID_NAME

Subnet name is not valid.

Requirements

  Windows NT/2000: Requires Windows 2000.
  Header: Declared in Dsgetdc.h.
  Library: Included as a resource in Netapi32.dll.
  Unicode: Implemented as Unicode and ANSI versions on Windows 2000.

See Also

Directory Service Functions, DsGetDcName, DsGetSiteName