Compartilhar via


Função DsValidateSubnetNameA (dsgetdc.h)

A função DsValidateSubnetName valida um nome de sub-rede no formulário xxx.xxx.xxx.xxx/YY. A parte Xxx.xxx.xxx.xxx deve ser um endereço IP válido. Yy deve ser o número de bits significativos mais à esquerda incluídos na máscara. Todos os bits do endereço IP que não são cobertos pela máscara devem ser especificados como zero.

Sintaxe

DSGETDCAPI DWORD DsValidateSubnetNameA(
  [in] LPCSTR SubnetName
);

Parâmetros

[in] SubnetName

Ponteiro para uma cadeia de caracteres terminada em nulo que especifica o nome da sub-rede a ser validada.

Retornar valor

Se a função retornar informações de conta, o valor retornado será NO_ERROR.

Se a função falhar, o valor retornado será o código de erro a seguir.

Comentários

Observação

O cabeçalho dsgetdc.h define DsValidateSubnetName como um alias que seleciona automaticamente a versão ANSI ou Unicode dessa função com base na definição da constante de pré-processador UNICODE. Misturar o uso do alias neutro de codificação com código que não seja neutro em codificação pode levar a incompatibilidades que resultam em erros de compilação ou de runtime. Para obter mais informações, consulte Convenções para protótipos de função.

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows Vista
Servidor mínimo com suporte Windows Server 2008
Plataforma de Destino Windows
Cabeçalho dsgetdc.h
Biblioteca Netapi32.lib
DLL Netapi32.dll

Confira também

Funções de serviço de diretório

Dsgetdcname

DsGetSiteName