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;否则, 将返回中 Winerror.h定义的相应 DNS 特定错误代码。 有关扩展的错误信息,请调用 GetLastError

注解

此函数是异步的。 注册成功后,将调用注册回调。 若要取消注册服务,请调用 DnsServiceDeRegister。   注册与调用进程的生存期相关联。 如果进程消失,服务将自动取消注册。

要求

要求
最低受支持的客户端 Windows 10 [仅限桌面应用]
目标平台 Windows
标头 windns.h
Library dnsapi.lib
DLL dnsapi.dll