Compartir a través de

Función EvtOpenSession (winevt.h)

  • Artículo

Establece una conexión a un equipo remoto que puede usar al llamar a las otras funciones del registro de eventos de Windows.

Sintaxis

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

Parámetros

[in] LoginClass

Método de conexión que se va a usar para conectarse al equipo remoto. Para conocer los valores posibles, consulte la enumeración EVT_LOGIN_CLASS .

[in] Login

Estructura de EVT_RPC_LOGIN que identifica el equipo remoto al que desea conectarse, las credenciales del usuario y el tipo de autenticación que se va a usar al conectarse.

[in] Timeout

Reservado. Debe ser cero.

[in] Flags

Reservado. Debe ser cero.

Valor devuelto

Si se ejecuta correctamente, la función devuelve un identificador de sesión que puede usar para acceder a la información del registro de eventos en el equipo remoto; en caso contrario, NULL. Si es NULL, llame a la función GetLastError para obtener el código de error.

Comentarios

Cuando haya terminado con el identificador de sesión, llame a la función EvtClose . Al cerrar el identificador de sesión, también se cerrarán todos los identificadores abiertos creados en la sesión (al cerrar los identificadores abiertos se cancela cualquier actividad actual en esos identificadores).

Para conectarse al equipo remoto, el equipo remoto debe habilitar la excepción de Firewall de Windows "Administración remota de registros de eventos" ; De lo contrario, al intentar usar el identificador de sesión, la llamada producirá un error con RPC_S_SERVER_UNAVAILABLE. El equipo al que se va a conectar debe ejecutar Windows Vista o posterior.

Esta función no valida las credenciales; Las credenciales se validan la primera vez que intenta usar el identificador de sesión. Si las credenciales no son válidas, se producirá un error en la llamada a ERROR_ACCESS_DENIED.

Ejemplos

Para obtener un ejemplo que muestra cómo usar esta función, consulte Acceso a equipos remotos.

Requisitos

Requisito Value
Cliente mínimo compatible Windows Vista [solo aplicaciones de escritorio]
Servidor mínimo compatible Windows Server 2008 [solo aplicaciones de escritorio]
Plataforma de destino Windows
Encabezado winevt.h
Library Wevtapi.lib
Archivo DLL Wevtapi.dll

Consulte también

EVT_LOGIN_CLASS

EvtClose