Freigeben über


EvtOpenSession-Funktion (winevt.h)

Stellt eine Verbindung mit einem Remotecomputer her, den Sie beim Aufrufen der anderen Windows-Ereignisprotokollfunktionen verwenden können.

Syntax

EVT_HANDLE EvtOpenSession(
  [in] EVT_LOGIN_CLASS LoginClass,
  [in] PVOID           Login,
  [in] DWORD           Timeout,
  [in] DWORD           Flags
);

Parameter

[in] LoginClass

Die Verbindungsmethode, die zum Herstellen einer Verbindung mit dem Remotecomputer verwendet werden soll. Mögliche Werte finden Sie in der EVT_LOGIN_CLASS-Enumeration .

[in] Login

Eine EVT_RPC_LOGIN Struktur, die den Remotecomputer, mit dem Sie eine Verbindung herstellen möchten, die Anmeldeinformationen des Benutzers und den Authentifizierungstyp identifiziert, der beim Herstellen einer Verbindung verwendet werden soll.

[in] Timeout

Reserviert. Muss Null sein.

[in] Flags

Reserviert. Muss Null sein.

Rückgabewert

Bei erfolgreicher Ausführung gibt die Funktion ein Sitzungshandle zurück, das Sie für den Zugriff auf Ereignisprotokollinformationen auf dem Remotecomputer verwenden können. andernfalls NULL. Wenn NULL, rufen Sie die GetLastError-Funktion auf, um den Fehlercode abzurufen.

Hinweise

Wenn Sie mit dem Sitzungshandle fertig sind, rufen Sie die EvtClose-Funktion auf. Wenn Sie das Sitzungshandle schließen, werden auch alle geöffneten Handles geschlossen, die in der Sitzung erstellt wurden .Durch das Schließen der geöffneten Handles werden alle aktuellen Aktivitäten auf diesen Handles abgebrochen.

Um eine Verbindung mit dem Remotecomputer herzustellen, muss der Remotecomputer die Windows-Firewall-Ausnahme "Remoteereignisprotokollverwaltung" aktivieren. Andernfalls wird beim Versuch, das Sitzungshandle zu verwenden, beim Aufruf ein Fehler mit RPC_S_SERVER_UNAVAILABLE ausgegeben. Auf dem Computer, mit dem Sie eine Verbindung herstellen, muss Windows Vista oder höher ausgeführt werden.

Diese Funktion überprüft die Anmeldeinformationen nicht. Die Anmeldeinformationen werden überprüft, wenn Sie zum ersten Mal versuchen, das Sitzungshandle zu verwenden. Wenn die Anmeldeinformationen ungültig sind, schlägt der Aufruf mit ERROR_ACCESS_DENIED fehl.

Beispiele

Ein Beispiel für die Verwendung dieser Funktion finden Sie unter Zugreifen auf Remotecomputer.

Anforderungen

Anforderung Wert
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

Weitere Informationen

EVT_LOGIN_CLASS

EvtClose