EvtClose-Funktion (winevt.h)
Schließt ein geöffnetes Handle.
Syntax
BOOL EvtClose(
[in] EVT_HANDLE Object
);
Parameter
[in] Object
Ein offenes Ereignishandle, das geschlossen werden soll.
Rückgabewert
| Rückgabecode/-wert | BESCHREIBUNG |
|---|---|
|
Die Funktion ist erfolgreich. |
|
Fehler bei der Funktion. Um den Fehlercode abzurufen, rufen Sie die GetLastError-Funktion auf. |
Hinweise
Sie können den Handle nicht mehr verwenden, nachdem der Handle geschlossen wurde. Wenn Sie ein übergeordnetes Handle schließen, werden auch alle geöffneten Handles geschlossen, die mit dem Handle erstellt wurden. Wenn Sie beispielsweise nach Ereignissen abfragen, enthält das Abfrageergebnis ein Handle für jedes Ereignis, das mit der Abfrage übereinstimmt. Bewährte Methode schlägt vor, dass Sie jedes Ereignishandle schließen, wenn Sie mit dem Ereignis fertig sind. Andernfalls werden beim Schließen des Abfragehandles auch alle Ereignishandles geschlossen.
Anforderungen
| Unterstützte Mindestversion (Client) | Windows Vista [nur Desktop-Apps] |
| Unterstützte Mindestversion (Server) | Windows Server 2008 [nur Desktop-Apps] |
| Zielplattform | Windows |
| Kopfzeile | winevt.h |
| Bibliothek | Wevtapi.lib |
| DLL | Wevtapi.dll |