Fonction DhcpV4FailoverGetScopeStatistics (dhcpsapi.h)

  • Article

La fonction DhcpV4FailoverGetScopeStatistics récupère les statistiques d’utilisation des adresses d’une étendue spécifique qui fait partie d’une relation de basculement.

Syntaxe

DWORD DHCP_API_FUNCTION DhcpV4FailoverGetScopeStatistics(
  [in, optional] LPWSTR                     ServerIpAddress,
  [in]           DHCP_IP_ADDRESS            ScopeId,
  [out]          LPDHCP_FAILOVER_STATISTICS *pStats
);

Paramètres

[in, optional] ServerIpAddress

Pointeur vers une chaîne Unicode terminée par null qui représente l’adresse IP ou le nom d’hôte du serveur DHCP.

[in] ScopeId

DHCP_IP_ADDRESS structure qui contient l’adresse d’étendue IPv4 des statistiques d’utilisation des adresses à récupérer.

[out] pStats

Pointeur vers une structure DHCP_FAILOVER_STATISTICS qui contient les informations d’utilisation des adresses pour scopeId.

Remarque  

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

 

Valeur retournée

Si la fonction réussit, elle retourne ERROR_SUCCESS.

Si la fonction échoue, elle retourne l’un des codes d’erreur suivants ou un code d’erreur à partir des codes d’erreur de l’API gestion du serveur DHCP.

Valeur Signification
ERROR_INVALID_PARAMETER
 Un ou plusieurs des paramètres n’étaient pas valides.

Configuration requise

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

Voir aussi

DhcpV4FailoverAddScopeToRelationship

DhcpV4FailoverDeleteScopeFromRelationship

DhcpV4FailoverGetScopeRelationship