EvtGetPublisherMetadataProperty, fonction (winevt.h)

Article
03/04/2024

Obtient la propriété de métadonnées du fournisseur spécifiée.

Syntaxe

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
);

Paramètres

[in] PublisherMetadata

Handle pour les métadonnées que la fonction EvtOpenPublisherMetadata retourne.

[in] PropertyId

Identificateur de la propriété de métadonnées à récupérer. Pour obtenir la liste des identificateurs de propriété, consultez l’énumération EVT_PUBLISHER_METADATA_PROPERTY_ID .

[in] Flags

Réservé. Doit être zéro.

[in] PublisherMetadataPropertyBufferSize

Taille de la mémoire tampon PublisherMetadataPropertyBuffer , en octets.

[in] PublisherMetadataPropertyBuffer

Mémoire tampon allouée à l’appelant qui recevra la propriété de métadonnées. La mémoire tampon contient un objet EVT_VARIANT . Vous pouvez définir ce paramètre sur NULL pour déterminer la taille de mémoire tampon requise.

[out] PublisherMetadataPropertyBufferUsed

Taille, en octets, de la mémoire tampon allouée à l’appelant utilisée par la fonction ou de la taille de mémoire tampon requise si la fonction échoue avec ERROR_INSUFFICIENT_BUFFER.

Valeur retournée

Code/valeur de retour	Description
TRUE	La fonction a réussi.
FALSE	Échec de la fonction. Pour obtenir le code d’erreur, appelez la fonction GetLastError .

Remarques

Attention

EvtGetEventMetadataProperty peut retourner de nombreux types de valeurs différents dans la variable EventMetadataPropertyBuffer . Si EventMetadataPropertyBuffer-Type> == EvtVarTypeEvtHandle, EventMetadataPropertyBuffer contient un handle qui doit être libéré. Lorsque vous avez terminé avec le handle, appelez la fonction EvtClose .

Exemples

Pour obtenir un exemple montrant comment utiliser cette fonction, consultez Obtention des métadonnées d’un fournisseur.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows Vista [applications de bureau uniquement]
Serveur minimal pris en charge	Windows Server 2008 [applications de bureau uniquement]
Plateforme cible	Windows
En-tête	winevt.h
Bibliothèque	Wevtapi.lib
DLL	Wevtapi.dll

Voir aussi

EvtOpenPublisherMetadata

Partager via