NdfRepairIncident-Funktion (ndfapi.h)
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 |
|---|---|
|
Die Reparatur war erfolgreich. |
|
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. |
|
Das NDF-Incidenthandle ist ungültig. |
|
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 |