DsValidateSubnetName

[This is preliminary documentation and subject to change.]

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
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.

Value Meaning
ERROR_INVALID_NAME Subnet name is not valid.

QuickInfo

  Windows NT: Requires version 5.0 or later.
  Windows: Unsupported.
  Windows CE: Unsupported.
  Header: Declared in dsgetdc.h.
  Import Library: Use netapi32.lib.
  Unicode: Implemented as Unicode and ANSI versions on Windows NT.

See Also

Networking (Net) Overview, Net Functions, DsGetDcName, DsGetSiteName