Freigeben über

NdfCreateGroupingIncident-Funktion (ndfapi.h)

  • Artikel

Die NdfCreateGroupingIncident-Funktion erstellt eine Sitzung, um Probleme mit der Peer-to-Peer-Gruppierung zu diagnostizieren.

Syntax

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
);

Parameter

[in, optional] CloudName

Typ: LPCWSTR

Der Name der PNRP-Cloud (Peer Name Resolution Protocol), in der die Gruppe erstellt wird. Bei NULL versucht die Sitzung nicht, Probleme im Zusammenhang mit PNRP zu diagnostizieren.

[in, optional] GroupName

Typ: LPCWSTR

Der Name der zu diagnostizierenden Gruppe. Bei NULL versucht die Sitzung nicht, Probleme im Zusammenhang mit der Gruppenverfügbarkeit zu diagnostizieren.

[in, optional] Identity

Typ: LPCWSTR

Die Identität, die ein Peer für den Zugriff auf die Gruppe verwendet. Bei NULL versucht die Sitzung nicht, Probleme im Zusammenhang mit der Fähigkeit der Gruppe, sich bei PNRP zu registrieren, zu diagnostizieren.

[in, optional] Invitation

Typ: LPCWSTR

Eine XML-Einladung, die von einem anderen Peer gewährt wird. Eine Einladung wird erstellt, wenn der einladende Peer PeerGroupCreateInvitation oder PeerGroupIssueCredentials aufruft. Wenn dieser Wert vorhanden ist, wird die Einladung überprüft, um sicherzustellen, dass format und ablauf gültig sind.

[in, optional] Addresses

Typ: SOCKET_ADDRESS_LIST*

Optionale Liste der Adressen der Peers, mit denen die Anwendung eine Verbindung herstellen möchte. Wenn dieser Parameter verwendet wird, diagnostiziert die Hilfsklasse die Konnektivität mit diesen Adressen.

[in, optional] appId

Typ: LPCWSTR

Anwendungs-ID für die aufrufende Anwendung.

[out] handle

Typ: NDFHANDLE*

Behandeln sie den Netzwerkdiagnoseframework-Incident.

Rückgabewert

Typ: HRESULT

Mögliche Rückgabewerte sind u. a. die folgenden:

Rückgabecode BESCHREIBUNG
S_OK
 Der Vorgang wurde erfolgreich ausgeführt.
NDF_E_BAD_PARAM
 Mindestens ein Parameter wurde nicht ordnungsgemäß bereitgestellt.

Hinweise

Der Grad der durchgeführten Diagnose hängt von den angegebenen Parametern ab.

  • Wenn keine Parameter angegeben sind, überprüft NDF den Gruppierungsdienst status, die status von Peer-to-Peer-Diensten (PNRP und Identity Manager) und die Windows-Uhrsynchronisierung.
  • Wenn CloudName angegeben ist, überprüft NDF die Gruppierungsfunktionalität in dieser Cloud.
  • Wenn GroupName angegeben ist, überprüft NDF, ob der Name in PNRP aufgelöst werden kann (oder rufen Sie die PNRP-Hilfsklasse auf, wenn der Name nicht aufgelöst werden kann) und überprüft die Firewalleinstellungen für die Gruppierung.
  • Wenn Identity angegeben ist, überprüft NDF die Fähigkeit von PNRP, den Gruppennamen bei dieser Identität zu registrieren. Wenn dies fehlschlägt, wird die PNRP-Hilfsklasse aufgerufen.
  • Wenn Invitation angegeben ist, wird der GroupName von der Einladung abgeleitet (wenn nicht auch ein GroupName angegeben wurde), und NDF überprüft das Format und die status der Einladung.
  • Wenn Adressen angegeben ist, überprüft die NDF, ob Windows eine Verbindung mit bis zu drei dieser Adressen herstellen kann.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Windows 7 [nur Desktop-Apps]
Unterstützte Mindestversion (Server) Windows Server 2008 R2 [nur Desktop-Apps]
Zielplattform Windows
Kopfzeile ndfapi.h
Bibliothek Ndfapi.lib
DLL Ndfapi.dll