DsValidateSubnetNameA function (dsgetdc.h)

Article
02/09/2023

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

DSGETDCAPI DWORD DsValidateSubnetNameA(
  [in] LPCSTR SubnetName
);

Parameters

[in] SubnetName

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.

Remarks

Note

The dsgetdc.h header defines DsValidateSubnetName as an alias which automatically selects the ANSI or Unicode version of this function based on the definition of the UNICODE preprocessor constant. Mixing usage of the encoding-neutral alias with code that not encoding-neutral can lead to mismatches that result in compilation or runtime errors. For more information, see Conventions for Function Prototypes.

Requirements

Requirement	Value
Minimum supported client	Windows Vista
Minimum supported server	Windows Server 2008
Target Platform	Windows
Header	dsgetdc.h
Library	Netapi32.lib
DLL	Netapi32.dll