通过

PNRP 和 WSALookupServiceBegin

  • 项目

PNRP 使用 WSALookupServiceBegin 函数启动允许应用程序执行以下操作的进程：

尝试执行其中一个函数的客户端使用 WSALookupServiceBegin、 WSALookupServiceNext 和 WSALookupServiceEnd 函数。

通过使用 WSANSPIoctl，可以异步使用查找服务。 有关异步使用查找服务函数的信息，请参阅 PNRP 和 WSANSPIoctl。

使用对等名称的过程不同于使用云。 本主题中分别介绍了每个过程。

解析名称

应用程序使用 WSALookupServiceBegin 获取在另一台计算机上注册的对等服务的 IP 地址、端口和协议。 WSALookupServiceBegin 函数用于启动名称解析过程，并设置参数和限制。 返回句柄，在调用 WSALookupServiceNext 和 WSANSPIoctl 时必须使用句柄。

lpqsRestrictions

解析对等名称时，lpqsRestrictions 参数引用的 LPWSAQUERYSET 结构必须包含以下值：

dwSize

指定此结构的大小。

lpszServiceInstanceName

指定要解析的对等名称。

lpServiceClassID

必须 SVCID_PNRPNAME。

lpVersion

保留的 必须为 NULL。

lpszComment

保留的 必须为 NULL。

dwNameSpace

必须是 NS_PNRPNAME 或 NS_ALL。

lpNSProviderID

必须为 NS_PROVIDER_PNRPNAME 或 NULL。

lpszContext

必须是云名称、空字符串或 NULL。 如果此值为 NULL 或空字符串，则使用默认云“Global_”。 否则，它必须指向有效的云名称。

dwNumberOfProtocols

保留的 必须为零 (0) 。

lpszQueryString

保留的 必须为 NULL。

dwNumberOfCsAddrs

保留的 必须为零 (0) 。

lpcsaBuffer

保留的 必须为 NULL。

dwOutputFlags

保留的 必须为零 (0) 。

lpBlob

必须是指向 BLOB 结构的指针或 NULL。 如果为 NULL，则使用默认值。 如果已设置， 则 lpBlob 指向 PNRPINFO 结构，并且必须设置 PNRPINFO 结构中的特定参数。 有关详细信息，请参阅 PNRPINFO 结构的以下说明。

PNRPINFO 结构

如果设置了 LPWSAQUERYSET 结构的 lpBlob 成员，则必须设置 PNRPINFO 结构的以下成员：

dwSize

指定此结构的大小。

lpwszIdentity

保留的 必须为 NULL。

nMaxResolve

指定请求的解析数。

dwTimeout

指定等待响应的请求超时期限。 默认为 30 秒。 最大为 600 秒 (10 分钟) 。

dwLifetime

保留的 必须为零 (0) 。

enResolveCriteria

必须是允许的值之一。 默认值为 PNRP_RESOLVE_CRITERIA_NON_CURRENT_PROCESS_PEER_NAME。 PNRP_RESOLVE_CRITERIA指定有效值。

dwFlags

必须为零 (0) 或 PNRPINFO_HINT。 默认值为零 (0)。

saHint

指定提示的 IP 地址。 尝试查找最近的对等名称时使用提示。 提示的格式为 IPv6 地址。 如果在查找最近的对等名称时未指定 saHint ，则改用本地计算机的 IPv6 地址。 如果未设置 dwFlags ，则忽略此成员。

enNameState

保留的 必须为零 (0) 。

dwControlFlags

PNRP 支持以下LUP_RETURN_* 标志：

值 说明
LUP_RETURN_NAME 返回名称和上下文。
LUP_RETURN_COMMENT 返回与名称关联的注释。
LUP_RETURN_ADDR 返回与名称关联的地址。

 

枚举网络云

lpqsRestrictions

枚举云时，lpqsRestrictions 参数引用的 LPWSAQUERYSET 结构必须包含以下值：

dwSize

指定此结构的大小。

lpszServiceInstanceName

必须为 NULL。

lpServiceClassID

必须 SVCID_PNRPCLOUD。

lpVersion

保留的 必须为 NULL。

lpszComment

保留的 必须为 NULL。

dwNameSpace

必须 NS_PNRPCLOUD。

lpNSProviderID

必须为 NS_PROVIDER_PNRPCLOUD 或 NULL。

lpszContext

保留的 必须为 NULL。

dwNumberOfProtocols

保留的 必须为零 (0) 。

lpszQueryString

保留的 必须为 NULL。

dwNumberOfCsAddrs

保留的 必须为零 (0) 。

lpcsaBuffer

保留的 必须为 NULL。

dwOutputFlags

保留的 必须为零 (0) 。

lpBlob

指向指向 PNRPCLOUDINFO 结构的 BLOB 结构的指针。 如果 lpBlob 为 NULL，则枚举所有云。

PNRPCLOUDINFO 结构

枚举云时，必须设置 PNRPCLOUDINFO 结构的以下成员：

dwSize

指定此结构的大小。

云

指向 一个 结构，该结构指定可用于筛选搜索结果的条件。 Cloud.Scope 成员可以是PNRP_SCOPE_ANY、PNRP_GLOBAL_SCOPE、PNRP_SITE_LOCAL_SCOPE或PNRP_LINK_LOCAL_SCOPE。 如果指定 了PNRP_SCOPE_ANY ，则返回所有云。 否则，仅返回与 Cloud.Scope 匹配的云。

enCloudState

保留的 必须为零 (0) 。

dwControlFlags

PNRP 支持以下LUP_RETURN_* 标志：

值 说明
LUP_RETURN_NAME 返回名称和上下文。
LUP_RETURN_BLOB 返回与此云关联的 BLOB 。

 

PNRP 和 BLOB

PNRP 和 WSALookupServiceEnd

PNRP 和 WSALookupServiceNext

PNRP 和 WSANSPIoctl

PNRP 和 WSAQUERYSET

PNRPCLOUDINFO

PNRPINFO

PNRP NSP 错误代码