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

Confira também

EvtGetPublisherMetadataProperty

EvtOpenEventMetadataEnum

EvtOpenPublisherEnum