EvtClose-Funktion (winevt.h)

  • Artikel

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
TRUE
 Die Funktion ist erfolgreich.
FALSE
 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