Condividi tramite

Funzione NdfCreateGroupingIncident (ndfapi.h)

  • Articolo

La funzione NdfCreateGroupingIncident crea una sessione per diagnosticare i problemi di funzionalità di raggruppamento peer-to-peer.

Sintassi

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

Parametri

[in, optional] CloudName

Tipo: LPCWSTR

Nome del cloud PNRP (Peer Name Resolution Protocol) in cui viene creato il gruppo. Se NULL, la sessione non tenterà di diagnosticare i problemi correlati a PNRP.

[in, optional] GroupName

Tipo: LPCWSTR

Nome del gruppo da diagnosticare. Se NULL, la sessione non tenterà di diagnosticare i problemi relativi alla disponibilità del gruppo.

[in, optional] Identity

Tipo: LPCWSTR

Identità usata da un peer per accedere al gruppo. Se NULL, la sessione non tenterà di diagnosticare i problemi relativi alla capacità del gruppo di registrarsi in PNRP.

[in, optional] Invitation

Tipo: LPCWSTR

Invito XML concesso da un altro peer. Un invito viene creato quando il peer che invia l'invito chiama PeerGroupCreateInvitation o PeerGroupIssueCredentials. Se questo valore è presente, l'invito verrà controllato per verificare che il formato e la scadenza siano validi.

[in, optional] Addresses

Tipo: SOCKET_ADDRESS_LIST*

Elenco facoltativo di indirizzi dei peer a cui l'applicazione sta tentando di connettersi. Se questo parametro viene usato, la classe helper diagnostica la connettività a questi indirizzi.

[in, optional] appId

Tipo: LPCWSTR

ID applicazione per l'applicazione chiamante.

[out] handle

Tipo: NDFHANDLE*

Gestire l'evento imprevisto di Network Diagnostics Framework.

Valore restituito

Tipo: HRESULT

I valori restituiti possibili includono, ma non sono limitati ai valori seguenti.

Codice restituito Descrizione
S_OK
 Operazione completata.
NDF_E_BAD_PARAM
 Uno o più parametri non sono stati forniti correttamente.

Commenti

Il livello di diagnosi eseguito dipende dai parametri forniti.

  • Se non vengono specificati parametri, NDF convaliderà lo stato del servizio di raggruppamento, lo stato dei servizi peer-to-peer (PNRP e Identity Manager) e la sincronizzazione dell'orologio di Windows.
  • Se CloudName è specificato, NDF convaliderà la funzionalità di raggruppamento nel cloud.
  • Se si specifica GroupName , NDF convaliderà che il nome può essere risolto in PNRP (oppure richiamare la classe helper PNRP se il nome non può essere risolto) e convalidare le impostazioni del firewall per il raggruppamento.
  • Se si specifica Identity , NDF convaliderà la capacità di PNRP di registrare GroupName con questa identità. In caso di errore, verrà richiamata la classe helper PNRP.
  • Se si specifica Invitation , groupName verrà derivato dall'invito (se non è stato specificato anche groupName ) e NDF convaliderà il formato e lo stato dell'invito.
  • Se si specifica Addresses , NDF convaliderà se Windows può connettersi a un massimo di tre di questi indirizzi.

Requisiti

Requisito Valore
Client minimo supportato Windows 7 [solo app desktop]
Server minimo supportato Windows Server 2008 R2 [solo app desktop]
Piattaforma di destinazione Windows
Intestazione ndfapi.h
Libreria Ndfapi.lib
DLL Ndfapi.dll