Funzione Dhcpv6RequestParams (dhcpv6csdk.h)

  • Articolo

La funzione Dhcpv6RequestParams richiede opzioni dalla cache del client DHCPv6 o direttamente dal server DHCPv6.

Sintassi

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

Parametri

forceNewInform

Se questo valore è impostato su TRUE, tutte le informazioni memorizzate nella cache disponibili verranno ignorate e verranno richieste nuove informazioni. In caso contrario, la richiesta viene inviata solo se non sono presenti informazioni memorizzate nella cache.

reserved

Riservato per utilizzi futuri. Deve essere impostato su NULL.

adapterName

GUID dell'adattatore per il quale si intende questa richiesta. Questo parametro non deve essere NULL.

classId

Puntatore a una struttura DHCPV6CAPI_CLASSID che contiene le informazioni ClassId binarie da usare per l'invio in rete. Questo parametro è facoltativo e,

recdParams

Struttura DHCPV6CAPI_PARAMS_ARRAY che contiene i parametri da ricevere dal server DHCPV6.

buffer

Buffer che contiene informazioni restituite da alcuni puntatori in recdParams.

pSize

Dimensioni del buffer. Quando la funzione restituisce ERROR_MORE_DATA, questo parametro conterrà le dimensioni, in byte, necessarie per completare l'operazione. Se la funzione ha esito positivo, questo parametro contiene il numero di byte utilizzati.

Valore restituito

Restituisce ERROR_SUCCESS al completamento.

Codice restituito Descrizione
ERROR_INVALID_PARAMETER
 Restituito se una delle condizioni seguenti è vera:
  • reserved ha un valore diverso da NULL.
  • AdapterName è NULL. In alternativa, non viene trovato alcun adattatore con il GUID specificato.
  • pSize è NULL.
  • buffer è NULL.
ERROR_MORE_DATA
 La chiamata a questa API è stata eseguita con memoria insufficiente allocata per il parametro Buffer , mentre pSize contiene le dimensioni effettive di memoria necessarie.
ERROR_INVALID_NAME
 AdapterName non è nel formato corretto. Deve essere in questo formato: {00000000-0000-0000-0000-000000000000}.

Requisiti

   
Client minimo supportato Windows Vista [app desktop | App UWP]
Server minimo supportato Windows Server 2008 [app desktop | App UWP]
Piattaforma di destinazione Windows
Intestazione dhcpv6csdk.h
Libreria Dhcpcsvc6.lib
DLL Dhcpcsvc6.dll