NdfCancelIncident-Funktion (ndfapi.h)
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 |
|---|---|
|
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 |