Функция DnsServiceRegister (windns.h)

  • Статья

Используется для регистрации обнаруживаемой службы на этом устройстве.

Синтаксис

DWORD DnsServiceRegister(
  PDNS_SERVICE_REGISTER_REQUEST pRequest,
  PDNS_SERVICE_CANCEL           pCancel
);

Параметры

pRequest

Указатель на структуру DNS_SERVICE_REGISTER_REQUEST , которая содержит сведения о регистримой службе.

pCancel

Необязательный (может быть nullptr) указатель на структуру DNS_SERVICE_CANCEL , которую можно использовать для отмены ожидающей асинхронной операции регистрации. Если нет nullptr, этот дескриптор должен оставаться действительным до отмены регистрации.

Возвращаемое значение

В случае успешного выполнения возвращает DNS_REQUEST_PENDING; в противном случае возвращает соответствующий код ошибки DNS, как определено в Winerror.h. Для получения дополнительных сведений об ошибке вызовите Метод GetLastError.

Комментарии

Эта функция является асинхронной. Обратный вызов регистрации будет вызываться после успешной регистрации. Чтобы отменить регистрацию службы, вызовите DnsServiceDeRegister.   Регистрация привязана к времени существования вызывающего процесса. Если процесс завершится, служба будет автоматически отменена.

Требования

Требование Значение
Минимальная версия клиента Windows 10 [только классические приложения]
Целевая платформа Windows
Header windns.h
Библиотека dnsapi.lib
DLL dnsapi.dll