Fonction DnsServiceRegister (windns.h)
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 |