Função EvtGetPublisherMetadataProperty (winevt.h)

Obtém a propriedade de metadados do provedor especificada.

Sintaxe

BOOL EvtGetPublisherMetadataProperty(
  [in]  EVT_HANDLE                         PublisherMetadata,
  [in]  EVT_PUBLISHER_METADATA_PROPERTY_ID PropertyId,
  [in]  DWORD                              Flags,
  [in]  DWORD                              PublisherMetadataPropertyBufferSize,
  [in]  PEVT_VARIANT                       PublisherMetadataPropertyBuffer,
  [out] PDWORD                             PublisherMetadataPropertyBufferUsed
);

Parâmetros

[in] PublisherMetadata

Um identificador para os metadados retornados pela função EvtOpenPublisherMetadata .

[in] PropertyId

O identificador da propriedade de metadados a ser recuperada. Para obter uma lista de identificadores de propriedade, consulte a enumeração EVT_PUBLISHER_METADATA_PROPERTY_ID .

[in] Flags

Reservado. Deve ser zero.

[in] PublisherMetadataPropertyBufferSize

O tamanho do buffer PublisherMetadataPropertyBuffer , em bytes.

[in] PublisherMetadataPropertyBuffer

Um buffer alocado pelo chamador que receberá a propriedade de metadados. O buffer contém um objeto EVT_VARIANT . Você pode definir esse parâmetro como NULL para determinar o tamanho do buffer necessário.

[out] PublisherMetadataPropertyBufferUsed

O tamanho, em bytes, do buffer alocado pelo chamador que a função usou ou o tamanho do buffer necessário se a função falhar com ERROR_INSUFFICIENT_BUFFER.

Retornar valor

Valor/código retornado	Descrição
TRUE	A função foi bem-sucedida.
FALSE	A função falhou. Para obter o código de erro, chame a função GetLastError .

Comentários

Cuidado  

EvtGetEventMetadataProperty pode retornar muitos tipos diferentes de valores na variável EventMetadataPropertyBuffer . Se EventMetadataPropertyBuffer-Type> == EvtVarTypeEvtHandle, EventMetadataPropertyBuffer conterá um identificador que precisa ser liberado. Quando terminar o identificador, chame a função EvtClose .

 

Exemplos

Para obter um exemplo que mostra como usar essa função, consulte Obtendo metadados de um provedor.

Requisitos

Requisito	Valor
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

Confira também

EvtOpenPublisherMetadata