Fonction NdfRepairIncident (ndfapi.h)

Article
02/29/2024

La fonction NdfRepairIncident répare un incident sans afficher d’interface utilisateur.

Syntaxe

void NdfRepairIncident(
  [in] NDFHANDLE    Handle,
  [in] RepairInfoEx *RepairEx,
       DWORD        dwWait
);

Paramètres

[in] Handle

Type : NDFHANDLE

Gérez l’incident network Diagnostics Framework. Ce handle doit correspondre au handle passé à NdfDiagnoseIncident.

[in] RepairEx

Type : RepairInfoEx*

Structure (obtenue à partir de NdfDiagnoseIncident) qui indique la réparation particulière à effectuer.

La mémoire allouée à ces structures doit être libérée ultérieurement. Pour obtenir un exemple de procédure, consultez les exemples de diagnostics réseau Microsoft Windows.

dwWait

Type : DWORD

Durée, en millisecondes, d’attente avant de mettre fin à la routine de diagnostic. INFINITE peut être passé à ce paramètre si aucun délai d’expiration n’est souhaité.

Valeur retournée

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

Code de retour	Description
S_OK	La réparation a réussi.
NDF_E_VALIDATION	La réparation s’est exécutée correctement, mais la validation NDF a toujours trouvé un problème de connectivité. Si cette valeur est retournée, la session doit être fermée en appelant NdfCloseIncident et une autre session doit être créée pour poursuivre le diagnostic.
E_HANDLE	Le handle d’incident NDF n’est pas valide.
WAIT_TIMEOUT	L’opération de réparation s’est terminée, car elle a pris plus de temps que le délai d’attente spécifié dans dwWait.

D’autres codes d’échec sont retournés si la réparation n’a pas pu s’exécuter. Dans ce cas, le client peut à nouveau appeler NdfRepairIncident avec une autre réparation.

Remarques

NdfRepairIncident ne peut être appelé que lorsque NdfDiagnoseIncident est utilisé pour diagnostics. C’est généralement le cas dans les scénarios où aucune interface utilisateur n’est affichée ou où l’expérience Windows standard n’est pas utilisée (comme avec Media Center et les applications incorporées). NdfRepairIncident ne doit pas être appelé lorsque NdfExecuteDiagnosis est utilisé.

Avant d’utiliser cette API, une application doit appeler une fonction de création d’incident telle que NdfCreateWebIncident pour commencer le processus de diagnostics NDF. L’application appelle ensuite NdfDiagnoseIncident pour diagnostiquer le problème. Si le processus diagnostics identifie certaines réparations possibles, l’application peut appeler NdfRepairIncident pour résoudre le problème sans afficher d’interface utilisateur. NdfCancelIncident peut éventuellement être appelé à partir d’un thread distinct si l’application souhaite annuler un appel NdfRepairIncident en cours. Enfin, l’application appelle NdfCloseIncident.

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

Voir aussi

NdfDiagnoseIncident

RepairInfoEx

Partager via