Función OpenEventLogA (winbase.h)

Artículo
08/27/2023

Abre un identificador en el registro de eventos especificado.

Sintaxis

HANDLE OpenEventLogA(
  [in] LPCSTR lpUNCServerName,
  [in] LPCSTR lpSourceName
);

Parámetros

[in] lpUNCServerName

Nombre de convención de nomenclatura universal (UNC) del servidor remoto en el que se va a abrir el registro de eventos. Si este parámetro es NULL, se usa el equipo local.

[in] lpSourceName

Nombre del registro.

Si especifica un registro personalizado y no se encuentra, el servicio de registro de eventos abre el registro de aplicación; sin embargo, no habrá ningún archivo de cadena de mensaje o categoría asociado.

Valor devuelto

Si la función se ejecuta correctamente, el valor devuelto es el identificador de un registro de eventos.

Si la función no se realiza correctamente, el valor devuelto es NULL. Para obtener información de error extendida, llame a GetLastError.

Comentarios

Para cerrar el identificador del registro de eventos, use la función CloseEventLog .

Ejemplos

Para obtener un ejemplo, consulte Consulta de información de eventos.

Nota:

El encabezado winbase.h define OpenEventLog como alias que selecciona automáticamente la versión ANSI o Unicode de esta función en función de la definición de la constante de preprocesador UNICODE. La combinación del uso del alias neutro de codificación con código que no es neutral de codificación puede provocar discrepancias que dan lugar a errores de compilación o en tiempo de ejecución. Para obtener más información, vea Convenciones para prototipos de función.

Requisitos


Cliente mínimo compatible	Windows 2000 Professional [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows 2000 Server [solo aplicaciones de escritorio]
Plataforma de destino	Windows
Encabezado	winbase.h (incluya Windows.h)
Library	Advapi32.lib
Archivo DLL	Advapi32.dll
Conjunto de API	ext-ms-win-advapi32-eventlog-ansi-l1-1-0 (introducido en Windows 10, versión 10.0.10240)