Fonction DhcpGetClassInfo (dhcpsapi.h)

  • Article

La fonction DhcpGetClassInfo retourne les informations de classe utilisateur ou fournisseur configurées sur un serveur DHCP spécifique.

Syntaxe

DWORD DhcpGetClassInfo(
  [in]  LPWSTR            ServerIpAddress,
  [in]  DWORD             ReservedMustBeZero,
  [in]  LPDHCP_CLASS_INFO PartialClassInfo,
  [out] LPDHCP_CLASS_INFO *FilledClassInfo
);

Paramètres

[in] ServerIpAddress

Chaîne Unicode qui spécifie l’adresse IP ou le nom d’hôte du serveur DHCP.

[in] ReservedMustBeZero

Réservé. Ce paramètre doit être défini sur 0.

[in] PartialClassInfo

DHCP_CLASS_INFO structure qui contient les données fournies par l’appelant pour les membres suivants, avec tous les autres champs initialisés.

  • Classname
  • ClassData
  • ClassDataLength
Ces champs ne doivent pas être null.

[out] FilledClassInfo

DHCP_CLASS_INFO structure retournée après la recherche qui contient les informations de classe complètes.

Remarque  

La mémoire de ce paramètre doit être libre à l’aide de DhcpRpcFreeMemory.

 

Valeur retournée

Cette fonction retourne ERROR_SUCCESS en cas d’appel réussi. Sinon, il retourne l’un des codes d’erreur de l’API gestion du serveur DHCP.

Code de retour Description
ERROR_ACCESS_DENIED
 Cet appel a été effectué par un client qui n’est pas membre du groupe de sécurité « Administrateurs DHCP ».
ERROR_INVALID_PARAMETER
 La structure DHCP_CLASS_INFO fournie dans PartialClassInfo a des valeurs null ou zéro pour un ou plusieurs des membres requis.
ERROR_DHCP_CLASS_NOT_FOUND
 Impossible de trouver un nom de classe correspondant aux informations fournies.

Notes

Une classe DHCP est une catégorie spécifique de client, définie par le fournisseur ou par un utilisateur. Un exemple de classe définie par le fournisseur serait tous les clients Windows 8, avec Microsoft comme fournisseur. Une classe définie par l’utilisateur se compose de ces clients avec des attributs spécifiques sélectionnés par un utilisateur ou un administrateur, tels que tous les ordinateurs portables ou clients qui prennent en charge les connexions sans fil.

Spécifications

   
Client minimal pris en charge Aucun pris en charge
Serveur minimal pris en charge Windows Server 2008 R2 [applications de bureau uniquement]
Plateforme cible Windows
En-tête dhcpsapi.h
Bibliothèque Dhcpsapi.lib
DLL Dhcpsapi.dll

Voir aussi

DHCP_CLASS_INFO

DhcpCreateClass