Funzione NdfRepairIncident (ndfapi.h)

Articolo
03/09/2024

La funzione NdfRepairIncident ripristina un evento imprevisto senza visualizzare un'interfaccia utente.

Sintassi

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

Parametri

[in] Handle

Tipo: NDFHANDLE

Gestire l'evento imprevisto di Network Diagnostics Framework. Questo handle deve corrispondere all'handle passato a NdfDiagnoseIncident.

[in] RepairEx

Tipo: RepairInfoEx*

Struttura (ottenuta da NdfDiagnoseIncident) che indica la particolare riparazione da eseguire.

La memoria allocata a queste strutture deve essere liberata in un secondo momento. Per un esempio di come eseguire questa operazione, vedere gli esempi di diagnostica di rete Di Microsoft Windows.

dwWait

Tipo: DWORD

Durata del tempo, in millisecondi, per attendere prima di terminare la routine di diagnostica. INFINITE può essere passato a questo parametro se non è desiderato alcun timeout.

Valore restituito

I valori restituiti possibili includono, ma non sono limitati a, quanto segue.

Codice restituito	Descrizione
S_OK	Correzione riuscita.
NDF_E_VALIDATION	La riparazione è stata eseguita correttamente, ma la convalida NDF ha ancora rilevato un problema di connettività. Se viene restituito questo valore, la sessione deve essere chiusa chiamando NdfCloseIncident e un'altra sessione deve essere creata per continuare la diagnosi.
E_HANDLE	L'handle degli eventi imprevisti NDF non è valido.
WAIT_TIMEOUT	L'operazione di ripristino è stata terminata perché ha richiesto più tempo del timeout specificato in dwWait.

Altri codici di errore vengono restituiti se la riparazione non è riuscita a eseguire. In tal caso, il client può chiamare nuovamente NdfRepairIncident con un'altra riparazione.

Commenti

NdfRepairIncident può essere chiamato solo quando NdfDiagnoseIncident viene usato per la diagnostica. Questo è in genere il caso negli scenari in cui non viene visualizzata alcuna interfaccia utente o dove l'esperienza di Windows standard non viene usata (come con Media Center e applicazioni incorporate). NdfRepairIncident non deve essere chiamato quando viene usato NdfExecuteDiagnosis .

Prima di usare questa API, un'applicazione deve chiamare una funzione di creazione di eventi imprevisti, ad esempio NdfCreateWebIncident per avviare il processo di diagnostica NDF. L'applicazione chiama quindi NdfDiagnoseIncident per diagnosticare il problema. Se il processo di diagnostica identifica alcune possibili riparazioni, l'applicazione può chiamare NdfRepairIncident per risolvere il problema senza visualizzare un'interfaccia utente. NdfCancelIncident può essere chiamato facoltativamente da un thread separato se l'applicazione vuole annullare una chiamata NdfRepairIncident in corso. Infine, l'applicazione chiama NdfCloseIncident.

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

Vedi anche

NdfDiagnoseIncident

RepairInfoEx

Share via