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.

Valor de retorno

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

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

Observações

Nota

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 do pré-processador UNICODE. A combinação do uso do alias neutro de codificação com código que não é neutro em codificação pode levar a incompatibilidades que resultam em erros de compilação ou de runtime. Para obter mais informações, consulte Conventions for Function Prototypes.

Requisitos

Requisito	Valor
de cliente com suporte mínimo	Windows Vista
servidor com suporte mínimo	Windows Server 2008
da Plataforma de Destino	Windows
cabeçalho	dsgetdc.h
biblioteca	Netapi32.lib
de DLL	Netapi32.dll

Consulte também

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

DsGetDcName

DsGetSiteName