Share via

NdfCancelIncident-Funktion (ndfapi.h)

  • Artikel

Die NdfCancelIncident-Funktion wird verwendet, um nicht benötigte Funktionen abzubrechen, die zuvor bei einem vorhandenen Incident aufgerufen wurden.

Syntax

void NdfCancelIncident(
  [in] NDFHANDLE Handle
);

Parameter

[in] Handle

Typ: NDFHANDLE

Behandeln sie den Netzwerkdiagnoseframework-Incident. Dieses Handle sollte mit dem Handle eines vorhandenen Incidents übereinstimmen.

Rückgabewert

Typ: HRESULT

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

Rückgabecode BESCHREIBUNG
S_OK
 Der Vorgang wurde erfolgreich ausgeführt.
 

Jedes andere Ergebnis als S_OK sollte als Fehler interpretiert werden.

Hinweise

Vor der Verwendung dieser API muss eine Anwendung eine Incidenterstellungsfunktion aufrufen, z. B. NdfCreateWebIncident.

NdfCancelIncident wird hauptsächlich verwendet, um Aufrufe von Funktionen wie NdfDiagnoseIncident oder NdfRepairIncident abzubrechen, die zuvor aufgerufen wurden, aber nicht mehr benötigt werden. Wenn NdfCancelIncident aufgerufen wird, beendet NDF die Diagnose/Reparatur so bald wie möglich, anstatt die anderen Funktionen aufzurufen (es sei denn, es wurden bereits Ergebnisse von diesen Funktionen zurückgegeben, in diesem Fall hat NdfCancelIncident keine Auswirkung).

NdfCloseIncident sollte verwendet werden, um einen Vorfall zu schließen, nachdem er behoben wurde, da NdfCancelIncident den Vorfall selbst nicht schließt.

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