通过

NdfCreateGroupingIncident 函数 (ndfapi.h)

  • 项目

NdfCreateGroupingIncident 函数创建一个会话来诊断对等分组功能问题。

语法

HRESULT NdfCreateGroupingIncident(
  [in, optional] LPCWSTR             CloudName,
  [in, optional] LPCWSTR             GroupName,
  [in, optional] LPCWSTR             Identity,
  [in, optional] LPCWSTR             Invitation,
  [in, optional] SOCKET_ADDRESS_LIST *Addresses,
  [in, optional] LPCWSTR             appId,
  [out]          NDFHANDLE           *handle
);

参数

[in, optional] CloudName

类型： LPCWSTR

创建组的云) PNRP (对等名称解析协议的名称。 如果 为 NULL，则会话不会尝试诊断与 PNRP 相关的问题。

[in, optional] GroupName

类型： LPCWSTR

要诊断的组的名称。 如果 为 NULL，则会话不会尝试诊断与组可用性相关的问题。

[in, optional] Identity

类型： LPCWSTR

对等方用于访问组的标识。 如果 为 NULL，则会话不会尝试诊断与组在 PNRP 中注册的能力相关的问题。

[in, optional] Invitation

类型： LPCWSTR

由另一对等方授予的 XML 邀请。 邀请方调用 PeerGroupCreateInvitation 或 PeerGroupIssueCredentials 时，将创建邀请。 如果存在此值，则将检查邀请以确保其格式和过期时间有效。

[in, optional] Addresses

类型： SOCKET_ADDRESS_LIST*

应用程序尝试连接到的对等方的地址的可选列表。 如果使用此参数，帮助程序类将诊断与这些地址的连接。

[in, optional] appId

类型： LPCWSTR

调用应用程序的应用程序 ID。

[out] handle

类型： NDFHANDLE*

网络诊断框架事件的句柄。

返回值

类型： HRESULT

可能的返回值包括但不限于以下值。

返回代码 说明
S_OK
 操作成功。
NDF_E_BAD_PARAM
 未正确提供一个或多个参数。

注解

执行的诊断级别取决于提供的参数。

  • 如果未指定参数，NDF 将验证分组服务状态、对等服务的状态 (PNRP 和Identity Manager) ，以及 Windows 时钟同步。
  • 如果指定 了 CloudName，NDF 将验证该云中的分组功能。
  • 如果指定 了 GroupName，NDF 将验证该名称是否可以在 PNRP (解析，或者在无法) 解析该名称时调用 PNRP 帮助程序类，并验证用于分组的防火墙设置。
  • 如果指定 了 Identity，NDF 将验证 PNRP 是否能够使用此标识注册 GroupName 。 如果此操作失败，将调用 PNRP 帮助程序类。
  • 如果指定了 邀请 ，则 GroupName 将从邀请 (如果未同时指定 GroupName) 并且 NDF 将验证邀请的格式和状态。
  • 如果指定了 “地址” ，NDF 将验证 Windows 是否可以连接到其中最多三个地址。

要求

要求 值
最低受支持的客户端 Windows 7 [仅限桌面应用]
最低受支持的服务器 Windows Server 2008 R2 [仅限桌面应用]
目标平台 Windows
标头 ndfapi.h
Library Ndfapi.lib
DLL Ndfapi.dll