Compartir a través de


Función OpenEventLogA (winbase.h)

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)

Consulte también

ClearEventLog

CloseEventLog

Funciones de registro de eventos

Clave de registro de eventos

ReadEventLog

ReportEvent