共用方式為

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

呼叫應用程式的應用程式識別碼。

[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
程式庫 Ndfapi.lib
Dll Ndfapi.dll