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

ピアがグループへのアクセスに使用する ID。 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
 1 つ以上のパラメーターが正しく指定されていません。

注釈

実行される診断のレベルは、指定されたパラメーターによって異なります。

  • パラメーターが指定されていない場合、NDF は、グループ化サービスの状態、ピア ツー ピア サービス (PNRP とIdentity Manager)、および Windows クロック同期の状態を検証します。
  • CloudName が指定されている場合、NDF はそのクラウドのグループ化機能を検証します。
  • GroupName が指定されている場合、NDF は PNRP で名前を解決できることを検証し (または、名前を解決できない場合は PNRP ヘルパー クラスを呼び出します)、グループ化のファイアウォール設定を検証します。
  • Identity が指定されている場合、NDF は、この ID に GroupName を登録する PNRP の機能を検証します。 これが失敗した場合は、PNRP ヘルパー クラスが呼び出されます。
  • Invitation が指定されている場合、GroupName は招待から派生し (GroupName も指定されていない場合)、NDF は招待の形式と状態を検証します。
  • [アドレス] が指定されている場合、NDF は Windows が最大 3 つのアドレスに接続できるかどうかを検証します。

要件

要件 値
サポートされている最小のクライアント Windows 7 [デスクトップ アプリのみ]
サポートされている最小のサーバー Windows Server 2008 R2 [デスクトップ アプリのみ]
対象プラットフォーム Windows
ヘッダー ndfapi.h
Library Ndfapi.lib
[DLL] Ndfapi.dll