Función EvtOpenPublisherMetadata (winevt.h)

Obtiene un identificador que se usa para leer los metadatos del proveedor especificado.

Sintaxis

EVT_HANDLE EvtOpenPublisherMetadata(
  [in, optional] EVT_HANDLE Session,
  [in]           LPCWSTR    PublisherId,
  [in, optional] LPCWSTR    LogFilePath,
  [in]           LCID       Locale,
  [in]           DWORD      Flags
);

Parámetros

[in, optional] Session

Identificador de sesión remota que devuelve la función EvtOpenSession . Establezca en NULL para obtener los metadatos de un proveedor en el equipo local.

[in] PublisherId

Nombre del proveedor. Para enumerar los nombres de los proveedores registrados en el equipo, llame a la función EvtOpenPublisherEnum .

[in, optional] LogFilePath

Ruta de acceso completa a un archivo de registro archivado que contiene los eventos registrados por el proveedor. Un archivo de registro archivado también contiene los metadatos del proveedor. Use este parámetro cuando el proveedor no esté registrado en el equipo local. Se establece en NULL al leer los metadatos de un proveedor registrado.

[in] Locale

Identificador de configuración regional que se va a usar al acceder a los metadatos localizados del proveedor. Para crear el identificador de configuración regional, use la macro MAKELCID. Establezca en 0 para usar el identificador de configuración regional del subproceso que llama.

[in] Flags

Reservado. Debe ser cero.

Valor devuelto

Si se ejecuta correctamente, la función devuelve un identificador a los metadatos del proveedor; en caso contrario, NULL. Si es NULL, llame a la función GetLastError para obtener el código de error.

Comentarios

Si especifica un archivo de registro archivado, esta función comprobará los metadatos del proveedor especificado en el archivo de registro. Si no se encuentran los metadatos del proveedor en el archivo de registro, la función buscará el proveedor en la lista de proveedores registrados en el equipo local.

Para leer los metadatos del proveedor, llame a la función EvtGetPublisherMetadataProperty . Para enumerar los eventos que define el proveedor, llame a la función EvtOpenEventMetadataEnum .

Debe llamar a la función EvtClose para cerrar el identificador de metadatos cuando haya terminado.

Ejemplos

Para obtener un ejemplo que muestra cómo usar esta función, consulte Obtención de metadatos de un proveedor.

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

EvtGetPublisherMetadataProperty

EvtOpenEventMetadataEnum

EvtOpenPublisherEnum