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 |