Compartilhar via

Função DhcpGetClientInfoVQ (dhcpsapi.h)

  • Artigo

A função DhcpGetClientInfoVQ recupera informações de registro de concessão de cliente DHCP do banco de dados do servidor DHCP.

Sintaxe

DWORD DHCP_API_FUNCTION DhcpGetClientInfoVQ(
  [in]  DHCP_CONST WCHAR            *ServerIpAddress,
  [in]  DHCP_CONST DHCP_SEARCH_INFO *SearchInfo,
  [out] LPDHCP_CLIENT_INFO_VQ       *ClientInfo
);

Parâmetros

[in] ServerIpAddress

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

[in] SearchInfo

Ponteiro para uma estrutura DHCP_SEARCH_INFO que define a chave usada para pesquisar o banco de dados de registro de concessão do cliente no servidor DHCP para um registro de cliente específico.

[out] ClientInfo

Ponteiro para a estrutura DHCP_CLIENT_INFO_VQ retornada por uma operação de pesquisa bem-sucedida.

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.

Comentários

O chamador dessa função deve liberar a memória usada pela estrutura DHCP_CLIENT_INFO_VQ retornada em ClientInfo.

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_CLIENT_INFO_VQ

DHCP_SEARCH_INFO