Compartir a través de


Función OpenEventLogA (winbase.h)

Abre un identificador para el registro de eventos especificado.

Sintaxis

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

Parámetros

[in] lpUNCServerName

El nombre de la 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 Application; 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 se produce un error en la función, el valor devuelto es NULL. Para obtener información de error extendida, llame a GetLastError.

Observaciones

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

Ejemplos

Para obtener un ejemplo, vea 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 neutral de codificación con código que no es neutral de codificación puede dar lugar a errores de coincidencia que dan lugar a errores de compilación o tiempo de ejecución. Para obtener más información, vea Conventions for Function Prototypes.

Requisitos

Requisito Valor
cliente mínimo admitido Windows 2000 Professional [solo aplicaciones de escritorio]
servidor mínimo admitido Windows 2000 Server [solo aplicaciones de escritorio]
de la plataforma de destino de Windows
encabezado de winbase.h (incluya Windows.h)
biblioteca de Advapi32.lib
DLL de Advapi32.dll
conjunto de API de ext-ms-win-advapi32-eventlog-ansi-l1-1-0 (introducido en Windows 10, versión 10.0.10240)

Consulte también

ClearEventLog

CloseEventLog de

funciones de registro de eventos de

de clave de registro de eventos de

ReadEventLog

ReportEvent