Fonction Dhcpv6RequestParams (dhcpv6csdk.h)

  • Article

La fonction Dhcpv6RequestParams demande des options à partir du cache client DHCPv6 ou directement du serveur DHCPv6.

Syntaxe

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

Paramètres

forceNewInform

Si cette valeur est définie sur TRUE, toutes les informations mises en cache disponibles sont ignorées et de nouvelles informations sont demandées. Sinon, la demande est envoyée uniquement s’il n’y a pas d’informations mises en cache.

reserved

Réservé pour un usage futur. Doit être défini sur NULL.

adapterName

GUID de l’adaptateur pour lequel cette requête est destinée. Ce paramètre ne doit pas être NULL.

classId

Pointeur vers une structure de DHCPV6CAPI_CLASSID qui contient les informations ClassId binaires à utiliser pour envoyer sur le réseau. Ce paramètre est facultatif.

recdParams

Structure DHCPV6CAPI_PARAMS_ARRAY qui contient les paramètres à recevoir du serveur DHCPV6.

buffer

Mémoire tampon pour contenir les informations retournées par certains pointeurs dans recdParams.

pSize

Taille de la mémoire tampon. Lorsque la fonction retourne ERROR_MORE_DATA, ce paramètre contient la taille, en octets, requise pour terminer l’opération. Si la fonction réussit, ce paramètre contient le nombre d’octets utilisés.

Valeur retournée

Retourne ERROR_SUCCESS en cas de réussite de l’exécution.

Code de retour Description
ERROR_INVALID_PARAMETER
 Retourné si l’une des conditions suivantes est remplie :
  • reserved a une valeur qui n’est pas NULL.
  • AdapterName a la valeur NULL. Ou aucun adaptateur n’est trouvé avec le GUID spécifié.
  • pSize a la valeur NULL.
  • la mémoire tampon a la valeur NULL.
ERROR_MORE_DATA
 L’appel à cette API a été effectué avec une mémoire insuffisante allouée pour le paramètre Buffer , tandis que pSize contient la taille de mémoire réelle requise.
ERROR_INVALID_NAME
 Le format AdapterName n’est pas correct. Il doit être au format suivant : {00000000-0000-0000-0000-000000000000}.

Spécifications

   
Client minimal pris en charge Windows Vista [applications de bureau | applications UWP]
Serveur minimal pris en charge Windows Server 2008 [applications de bureau | applications UWP]
Plateforme cible Windows
En-tête dhcpv6csdk.h
Bibliothèque Dhcpcsvc6.lib
DLL Dhcpcsvc6.dll