Função EvtOpenPublisherMetadata (winevt.h)
Obtém um identificador que você usa para ler os metadados do provedor especificado.
Sintaxe
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
Um identificador de sessão remota que a função EvtOpenSession retorna. Defina como NULL para obter os metadados de um provedor no computador local.
[in] PublisherId
O nome do provedor. Para enumerar os nomes dos provedores registrados no computador, chame a função EvtOpenPublisherEnum .
[in, optional] LogFilePath
O caminho completo para um arquivo de log arquivado que contém os eventos que o provedor registrou. Um arquivo de log arquivado também contém os metadados do provedor. Use esse parâmetro quando o provedor não estiver registrado no computador local. Defina como NULL ao ler os metadados de um provedor registrado.
[in] Locale
O identificador de localidade a ser usado ao acessar os metadados localizados do provedor. Para criar o identificador de localidade, use a macro MAKELCID. Defina como 0 para usar o identificador de localidade do thread de chamada.
[in] Flags
Reservado. Deve ser zero.
Valor retornado
Se tiver êxito, a função retornará um identificador para os metadados do provedor; caso contrário, NULL. Se FOR NULL, chame a função GetLastError para obter o código de erro.
Comentários
Se você especificar um arquivo de log arquivado, essa função marcar para os metadados do provedor especificado no arquivo de log. Se os metadados do provedor não forem encontrados no arquivo de log, a função procurará o provedor na lista de provedores registrados no computador local.
Para ler os metadados do provedor, chame a função EvtGetPublisherMetadataProperty . Para enumerar os eventos definidos pelo provedor, chame a função EvtOpenEventMetadataEnum .
Você deve chamar a função EvtClose para fechar o identificador de metadados quando terminar.
Exemplos
Para obter um exemplo que mostra como usar essa função, consulte Obtendo metadados de um provedor.
Requisitos
| Cliente mínimo com suporte | Windows Vista [somente aplicativos da área de trabalho] |
| Servidor mínimo com suporte | Windows Server 2008 [somente aplicativos da área de trabalho] |
| Plataforma de Destino | Windows |
| Cabeçalho | winevt.h |
| Biblioteca | Wevtapi.lib |
| DLL | Wevtapi.dll |