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 |