DhcpServerQueryAttributes, fonction (dhcpsapi.h)

La fonction DhcpServerQueryAttributes retourne un tableau d’attributs définis sur le serveur DHCP.

Syntaxe

DWORD DhcpServerQueryAttributes(
  [in]  LPWSTR              ServerIpAddr,
  [in]  ULONG               dwReserved,
  [in]  ULONG               dwAttribCount,
  [in]  DHCP_ATTRIB_ID []   pDhcpAttribs,
  [out] LPDHCP_ATTRIB_ARRAY *pDhcpAttribArr
);

Paramètres

[in] ServerIpAddr

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

[in] dwReserved

Réservé. Cette valeur doit être définie sur zéro.

[in] dwAttribCount

Spécifie le nombre d’attributs répertoriés dans pDhcpAttribArr.

[in] pDhcpAttribs

Spécifie un tableau de valeurs DHCP_ATTRIB_ID (de longueur dwAttribCount) à partir de laquelle récupérer les informations d’attribut correspondantes.

[out] pDhcpAttribArr

Pointeur vers une structure de DHCP_ATTRIB_ARRAY qui contient les attributs correspondant directement aux valeurs d’ID d’attribut spécifiées dans pDhcpAttribs[].

Valeur retournée

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

Remarques

Un attribut de serveur DHCP est une valeur qui peut être interrogée pour déterminer les fonctionnalités prises en charge et disponibles.

Les appelants de cette fonction doivent libérer la mémoire pointée par pDhcpAttribs et pDhcpAttribArr après utilisation.

Configuration requise

Condition requise	Valeur
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_ATTRIB_ARRAY

DhcpServerQueryAttribute