Fonction DnsServiceRegister (windns.h)

  • Article

Utilisé pour inscrire un service détectable sur cet appareil.

Syntaxe

DWORD DnsServiceRegister(
  PDNS_SERVICE_REGISTER_REQUEST pRequest,
  PDNS_SERVICE_CANCEL           pCancel
);

Paramètres

pRequest

Pointeur vers une structure de DNS_SERVICE_REGISTER_REQUEST qui contient des informations sur le service à inscrire.

pCancel

Pointeur facultatif (il peut s’agir nullptr) d’une structure DNS_SERVICE_CANCEL qui peut être utilisé pour annuler une opération d’inscription asynchrone en attente. Si ce n’est pas nullptr, ce handle doit rester valide jusqu’à l’annulation de l’inscription.

Valeur retournée

En cas de réussite, retourne DNS_REQUEST_PENDING ; sinon, retourne le code d’erreur dns approprié tel que défini dans Winerror.h. Pour obtenir des informations d’erreur étendues, appelez GetLastError.

Remarques

Cette fonction est asynchrone. Le rappel d’inscription sera appelé une fois l’inscription réussie. Pour désinscrire le service, appelez DnsServiceDeRegister.   L’inscription est liée à la durée de vie du processus d’appel. Si le processus disparaît, le service est automatiquement désinscrit.

Configuration requise

Condition requise Valeur
Client minimal pris en charge Windows 10 (applications de bureau uniquement)
Plateforme cible Windows
En-tête windns.h
Bibliothèque dnsapi.lib
DLL dnsapi.dll