Dhcpv6ReleasePrefix, fonction (dhcpv6csdk.h)

  • Article

La fonction Dhcpv6ReleasePrefix libère un préfixe précédemment acquis avec la fonction Dhcpv6RequestPrefix .

Syntaxe

DWORD Dhcpv6ReleasePrefix(
  [in] LPWSTR                         adapterName,
  [in] LPDHCPV6CAPI_CLASSID           classId,
  [in] LPDHCPV6PrefixLeaseInformation leaseInfo
);

Paramètres

[in] adapterName

Nom de l’adaptateur sur lequel la demande pdD doit être envoyée.

[in] classId

Pointeur vers une structure de DHCPV6CAPI_CLASSID qui contient les informations ClassId binaires à utiliser pour envoyer sur le réseau.

Note Le code d’option DHCPv6 15 (0x000F) n’est pas pris en charge par cette API. En règle générale, l’option Classe utilisateur est utilisée par un client pour identifier le type ou la catégorie d’utilisateur ou d’application qu’elle représente. Un serveur sélectionne les informations de configuration du client en fonction des classes identifiées dans cette option.
 

[in] leaseInfo

Pointeur vers une structure DHCPV6CAPIPrefixLeaseInformation utilisée pour libérer le préfixe.

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 :
  • AdapterName a la valeur NULL. Ou aucun adaptateur n’est trouvé avec le GUID spécifié.
  • prefixleaseInfo a la valeur NULL.
ERROR_INVALID_NAME
 Le format AdapterName n’est pas correct. Il doit être au format suivant : {00000000-0000-0000-0000-000000000000}.

Remarques

Les messages de mise en production envoyés à la suite de l’appel à cette fonction doivent contenir les valeurs suivantes pour les champs T1 et T2 de la structure DHCPV6CAPIPrefixLeaseInformation fournie dans le paramètre prefixleaseInfo :

  • T1 : heure de renouvellement du préfixe, en secondes spécifiées comme valeurs de temps absolues.
  • T2 : heure de rebinaison du préfixe, en secondes spécifiées comme valeurs de temps absolues.

Configuration requise

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