Compartilhar via

Função Dhcpv6RequestParams (dhcpv6csdk.h)

  • Artigo

A função Dhcpv6RequestParams solicita opções do cache do cliente DHCPv6 ou diretamente do servidor DHCPv6.

Sintaxe

DWORD Dhcpv6RequestParams(
  BOOL                    forceNewInform,
  LPVOID                  reserved,
  LPWSTR                  adapterName,
  LPDHCPV6CAPI_CLASSID    classId,
  DHCPV6CAPI_PARAMS_ARRAY recdParams,
  LPBYTE                  buffer,
  LPDWORD                 pSize
);

Parâmetros

forceNewInform

Se esse valor for definido como TRUE, todas as informações armazenadas em cache disponíveis serão ignoradas e novas informações serão solicitadas. Caso contrário, a solicitação só será enviada se não houver informações armazenadas em cache.

reserved

Reservado para uso futuro. Deve ser definido como NULL.

adapterName

GUID do adaptador para o qual essa solicitação se destina. Esse parâmetro não deve ser NULL.

classId

Ponteiro para uma estrutura DHCPV6CAPI_CLASSID que contém as informações de ClassId binárias a serem usadas para enviar na transmissão. Esse parâmetro é opcional.

recdParams

Uma estrutura DHCPV6CAPI_PARAMS_ARRAY que contém os parâmetros a serem recebidos do servidor DHCPV6.

buffer

Um buffer para conter informações retornadas por alguns ponteiros em recdParams.

pSize

O tamanho do buffer. Quando a função retornar ERROR_MORE_DATA, esse parâmetro conterá o tamanho, em bytes, necessário para concluir a operação. Se a função for bem-sucedida, esse parâmetro conterá o número de bytes usados.

Valor retornado

Retorna ERROR_SUCCESS após a conclusão bem-sucedida.

Código de retorno Descrição
ERROR_INVALID_PARAMETER
 Retornado se uma das seguintes condições for verdadeira:
  • reserved tem um valor que não é NULL.
  • AdapterName é NULL. Ou nenhum adaptador é encontrado com o GUID especificado.
  • pSize é NULL.
  • buffer é NULL.
ERROR_MORE_DATA
 A chamada para essa API foi feita com memória insuficiente alocada para o parâmetro Buffer , enquanto pSize contém o tamanho real da memória necessário.
ERROR_INVALID_NAME
 O AdapterName não está no formato correto. Ele deve estar neste formato: {00000000-0000-0000-0000-000000000000}.

Requisitos

   
Cliente mínimo com suporte Windows Vista [aplicativos da área de trabalho | Aplicativos UWP]
Servidor mínimo com suporte Windows Server 2008 [aplicativos da área de trabalho | Aplicativos UWP]
Plataforma de Destino Windows
Cabeçalho dhcpv6csdk.h
Biblioteca Dhcpcsvc6.lib
DLL Dhcpcsvc6.dll