Función EvtOpenLog (winevt.h)

Obtiene un identificador de un canal o archivo de registro que puede usar para obtener información sobre el canal o el archivo de registro.

Sintaxis

EVT_HANDLE EvtOpenLog(
  [in] EVT_HANDLE Session,
  [in] LPCWSTR    Path,
  [in] DWORD      Flags
);

Parámetros

[in] Session

Identificador de sesión remota que devuelve la función EvtOpenSession . Establezca en NULL para abrir un canal o iniciar sesión en el equipo local.

[in] Path

Nombre del canal o la ruta de acceso completa al archivo de registro exportado.

[in] Flags

Marca que determina si el parámetro Path apunta a un archivo de registro o canal. Para conocer los valores posibles, consulte la enumeración EVT_OPEN_LOG_FLAGS .

Valor devuelto

Si se ejecuta correctamente, la función devuelve un identificador al archivo o canal; en caso contrario, NULL. Si es NULL, llame a la función GetLastError para obtener el código de error.

Comentarios

Las rutas de acceso relativas y las variables de entorno no se pueden usar al especificar un archivo. Se puede usar una ruta de acceso de convención de nomenclatura universal (UNC) para buscar el archivo. Es necesario realizar cualquier expansión de ruta de acceso relativa y variable de entorno antes de realizar llamadas API.

Para obtener información sobre el canal o el archivo de registro, llame a la función EvtGetLogInfo .

Requisitos

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

EvtClearLog

EvtExportLog

EvtGetLogInfo