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 |