Функция 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 |