NdfRepairIncident-Funktion (ndfapi.h)

Artikel
03/06/2024

Die NdfRepairIncident-Funktion repariert einen Vorfall, ohne eine Benutzeroberfläche anzuzeigen.

Syntax

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

Parameter

[in] Handle

Typ: NDFHANDLE

Behandeln sie den Netzwerkdiagnoseframework-Incident. Dieses Handle sollte mit dem an NdfDiagnoseIncident übergebenen Handle übereinstimmen.

[in] RepairEx

Typ: RepairInfoEx*

Eine -Struktur (abgerufen aus NdfDiagnoseIncident), die die jeweilige reparatur angibt, die ausgeführt werden soll.

Speicher, der diesen Strukturen zugeordnet ist, sollte später freigegeben werden. Ein Beispiel dafür finden Sie in den Microsoft Windows-Netzwerkdiagnosebeispielen.

dwWait

Art: DWORD

Die Zeitdauer in Millisekunden, die vor dem Beenden der Diagnoseroutine gewartet werden soll. INFINITE kann an diesen Parameter übergeben werden, wenn kein Timeout gewünscht wird.

Rückgabewert

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

Rückgabecode	BESCHREIBUNG
S_OK	Die Reparatur war erfolgreich.
NDF_E_VALIDATION	Die Reparatur wurde erfolgreich ausgeführt, aber bei der NDF-Überprüfung wurde weiterhin ein Konnektivitätsproblem festgestellt. Wenn dieser Wert zurückgegeben wird, sollte die Sitzung durch Aufrufen von NdfCloseIncident geschlossen werden, und eine andere Sitzung sollte erstellt werden, um die Diagnose fortzusetzen.
E_HANDLE	Das NDF-Incidenthandle ist ungültig.
WAIT_TIMEOUT	Der Reparaturvorgang wurde beendet, da er länger als das in dwWait angegebene Timeout gedauert hat.

Andere Fehlercodes werden zurückgegeben, wenn die Reparatur nicht ausgeführt werden konnte. In diesem Fall kann der Client NdfRepairIncident mit einer anderen Reparatur erneut aufrufen.

Hinweise

NdfRepairIncident kann nur aufgerufen werden, wenn NdfDiagnoseIncident für Diagnose verwendet wird. Dies ist in der Regel in Szenarien der Fall, in denen keine Benutzeroberfläche angezeigt wird oder in denen die Windows-Standardumgebung nicht verwendet wird (wie bei Media Center und eingebetteten Anwendungen). NdfRepairIncident sollte nicht aufgerufen werden, wenn NdfExecuteDiagnosis verwendet wird.

Vor der Verwendung dieser API muss eine Anwendung eine Incidenterstellungsfunktion wie NdfCreateWebIncident aufrufen, um den NDF-Diagnose-Prozess zu starten. Die Anwendung ruft dann NdfDiagnoseIncident auf, um das Problem zu diagnostizieren. Wenn der Diagnose-Prozess einige mögliche Reparaturen identifiziert, kann die Anwendung NdfRepairIncident aufrufen, um das Problem zu beheben, ohne eine Benutzeroberfläche anzuzeigen. NdfCancelIncident kann optional aus einem separaten Thread aufgerufen werden, wenn die Anwendung einen laufenden NdfRepairIncident-Aufruf abbrechen möchte. Schließlich ruft die Anwendung NdfCloseIncident auf.

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

Weitere Informationen

NdfDiagnoseIncident

RepairInfoEx

Share via