Fonction DhcpAddServer (dhcpsapi.h)

La fonction DhcpAddServer tente d’ajouter un nouveau serveur à la liste existante des serveurs DHCP gérés dans le service d’annuaire de domaine. Si le serveur DHCP spécifié existe déjà dans le service d’annuaire, une erreur est retournée.

Syntaxe

DWORD DhcpAddServer(
  [in] DWORD              Flags,
  [in] LPVOID             IdInfo,
  [in] LPDHCP_SERVER_INFO NewServer,
  [in] LPVOID             CallbackFn,
  [in] LPVOID             CallbackData
);

Paramètres

[in] Flags

Réservé pour un usage futur. Ce champ doit être défini sur 0x00000000.

[in] IdInfo

Pointeur vers une adresse contenant le bloc d’ID du serveur. Ce champ doit avoir la valeur Null.

[in] NewServer

Pointeur vers une structure DHCP_SERVER_INFO contenant des informations sur le nouveau serveur DHCP. Les membres DsLocation et DsLocType présents dans cette structure ne sont pas valides dans cette implémentation et doivent avoir la valeur Null. Le membre Version de cette structure doit avoir la valeur 0.

[in] CallbackFn

Pointeur vers la fonction de rappel qui sera appelée une fois l’opération d’ajout du serveur terminée. Ce champ doit avoir la valeur Null.

[in] CallbackData

Pointeur vers un bloc de données contenant la structure mise en forme pour les informations de rappel. Ce champ doit avoir la valeur Null.

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.

Spécifications

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

Voir aussi

DHCP_SERVER_INFO

DhcpDeleteServer