EvtGetPublisherMetadataProperty, fonction (winevt.h)
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 |
---|---|
|
La fonction a réussi. |
|
Échec de la fonction. Pour obtenir le code d’erreur, appelez la fonction GetLastError . |
Remarques
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
Commentaires
https://aka.ms/ContentUserFeedback.
Bientôt disponible : Tout au long de 2024, nous allons supprimer progressivement GitHub Issues comme mécanisme de commentaires pour le contenu et le remplacer par un nouveau système de commentaires. Pour plus d’informations, consultezEnvoyer et afficher des commentaires pour