Dhcpv6RenewPrefix, fonction (dhcpv6csdk.h)

  • Article

La fonction Dhcpv6RenewPrefix renouvelle un préfixe précédemment acquis avec la fonction Dhcpv6RequestPrefix .

Syntaxe

DWORD Dhcpv6RenewPrefix(
  [in]      LPWSTR                         adapterName,
  [in]      LPDHCPV6CAPI_CLASSID           pclassId,
  [in, out] LPDHCPV6PrefixLeaseInformation prefixleaseInfo,
  [out]     DWORD                          *pdwTimeToWait,
  [in]      DWORD                          bValidatePrefix
);

Paramètres

[in] adapterName

GUID de l’adaptateur sur lequel le renouvellement de préfixe doit être envoyé.

[in] pclassId

Pointeur vers une structure DHCPV6CAPI_CLASSID qui contient les informations ClassId binaires à envoyer sur le réseau. Ce paramètre peut être NULL.

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, out] prefixleaseInfo

Pointeur vers une structure DHCPV6PrefixLeaseInformation qui contient les informations de bail de préfixe.

[out] pdwTimeToWait

Contient le nombre de secondes pendant lesquelles une application demandeuse doit attendre avant d’appeler la fonction Dhcpv6RenewPrefix pour renouveler ses préfixes acquis. La valeur 0xFFFFFFFF indique que l’application n’a pas besoin de renouveler son bail.

[in] bValidatePrefix

Spécifie au client DHCPv6 s’il faut envoyer ou non un REBIND afin de valider les liaisons de préfixe. TRUE indique qu’un REBIND est requis. FALSE indique que RENEW est obligatoire.

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.
  • pdwTimeToWait a la valeur NULL.
ERROR_MORE_DATA
 Retourné si l’API répond avec plus de préfixes qu’il n’y a de mémoire allouée.
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 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