Função DhcpGetSubnetInfoVQ (dhcpsapi.h)

Artigo
08/23/2023

A função DhcpGetSubnetInfoVQ recupera as informações sobre uma sub-rede IPv4 específica definida no servidor DHCP.

Sintaxe

DWORD DHCP_API_FUNCTION DhcpGetSubnetInfoVQ(
  [in]  DHCP_CONST WCHAR      *ServerIpAddress,
  [in]  DHCP_IP_ADDRESS       SubnetAddress,
  [out] LPDHCP_SUBNET_INFO_VQ *SubnetInfo
);

Parâmetros

[in] ServerIpAddress

Cadeia de caracteres Unicode que especifica o endereço IP ou o nome do host do servidor DHCP.

[in] SubnetAddress

DHCP_IP_ADDRESS estrutura que contém o endereço IPv4 da sub-rede para a qual as informações serão modificadas.

[out] SubnetInfo

Uma estrutura DHCP_SUBNET_INFO_VQ que contém as informações retornadas para a sub-rede que corresponde ao endereço IPv4 especificado por SubnetAddress.

Observação

A memória desse parâmetro deve ser livre usando DhcpRpcFreeMemory.

Valor retornado

Essa função retorna ERROR_SUCCESS após uma chamada bem-sucedida. Caso contrário, ele retornará um dos códigos de erro da API de Gerenciamento de Servidor DHCP.

Código de retorno	Descrição
ERROR_ACCESS_DENIED	Essa chamada foi executada por um cliente que não é membro do grupo de segurança "Administradores DHCP".
ERROR_DHCP_JET_ERROR	Erro ao acessar o banco de dados do servidor DHCP.
ERROR_DHCP_SUBNET_NOT_PRESENT	A sub-rede especificada não é definida no servidor DHCP.
ERROR_INVALID_PARAMETER	Um dos parâmetros fornece um valor inválido.

Requisitos


Cliente mínimo com suporte	Nenhum compatível
Servidor mínimo com suporte	Windows Server 2008 R2 [somente aplicativos da área de trabalho]
Plataforma de Destino	Windows
Cabeçalho	dhcpsapi.h
Biblioteca	Dhcpsapi.lib
DLL	Dhcpsapi.dll

Confira também

DHCP_SUBNET_INFO_VQ

Compartilhar via