Partager via

NdfCreateGroupingIncident, fonction (ndfapi.h)

  • Article

La fonction NdfCreateGroupingIncident crée une session pour diagnostiquer les problèmes de fonctionnalité de regroupement d’égal à égal.

Syntaxe

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

Paramètres

[in, optional] CloudName

Type : LPCWSTR

Nom du cloud PNRP (Peer Name Resolution Protocol) où le groupe est créé. Si la valeur est NULL, la session ne tente pas de diagnostiquer les problèmes liés à PNRP.

[in, optional] GroupName

Type : LPCWSTR

Nom du groupe à diagnostiquer. Si la valeur est NULL, la session ne tente pas de diagnostiquer les problèmes liés à la disponibilité du groupe.

[in, optional] Identity

Type : LPCWSTR

Identité qu’un homologue utilise pour accéder au groupe. Si la valeur est NULL, la session ne tente pas de diagnostiquer les problèmes liés à la capacité du groupe à s’inscrire dans PNRP.

[in, optional] Invitation

Type : LPCWSTR

Invitation XML accordée par un autre homologue. Une invitation est créée lorsque l’homologue invitant appelle PeerGroupCreateInvitation ou PeerGroupIssueCredentials. Si cette valeur est présente, l’invitation est vérifiée pour s’assurer que son format et son expiration sont valides.

[in, optional] Addresses

Type : SOCKET_ADDRESS_LIST*

Liste facultative des adresses des homologues auxquels l’application tente de se connecter. Si ce paramètre est utilisé, la classe d’assistance diagnostiquera la connectivité à ces adresses.

[in, optional] appId

Type : LPCWSTR

ID d’application pour l’application appelante.

[out] handle

Type : NDFHANDLE*

Gérez l’incident de l’infrastructure de diagnostics réseau.

Valeur retournée

Type : HRESULT

Les valeurs de retour possibles incluent, sans s’y limiter, les éléments suivants.

Code de retour Description
S_OK
 L’opération a réussi.
NDF_E_BAD_PARAM
 Un ou plusieurs paramètres n’ont pas été fournis correctement.

Remarques

Le niveau de diagnostic effectué dépend des paramètres fournis.

  • Si aucun paramètre n’est spécifié, NDF valide le service de regroupement status, la status des services d’égal à égal (PNRP et Identity Manager) et la synchronisation d’horloge Windows.
  • Si CloudName est spécifié, NDF valide la fonctionnalité de regroupement dans ce cloud.
  • Si GroupName est spécifié, NDF vérifie que le nom peut être résolu dans PNRP (ou appelle la classe d’assistance PNRP si le nom ne peut pas être résolu) et valide les paramètres de pare-feu pour le regroupement.
  • Si l’identité est spécifiée, NDF valide la capacité de PNRP à inscrire groupName auprès de cette identité. En cas d’échec, la classe d’assistance PNRP est appelée.
  • Si l’invitation est spécifiée, groupName est dérivé de l’invitation (si un GroupName n’a pas été également spécifié) et NDF valide le format et l’status de l’invitation.
  • Si des adresses sont spécifiées, NDF vérifie si Windows peut se connecter à jusqu’à trois de ces adresses.

Configuration requise

Condition requise Valeur
Client minimal pris en charge Windows 7 [applications de bureau uniquement]
Serveur minimal pris en charge Windows Server 2008 R2 [applications de bureau uniquement]
Plateforme cible Windows
En-tête ndfapi.h
Bibliothèque Ndfapi.lib
DLL Ndfapi.dll