EvtOpenPublisherMetadata, fonction (winevt.h)

Article
08/27/2023

Obtient un handle que vous utilisez pour lire les métadonnées du fournisseur spécifié.

Syntaxe

EVT_HANDLE EvtOpenPublisherMetadata(
  [in, optional] EVT_HANDLE Session,
  [in]           LPCWSTR    PublisherId,
  [in, optional] LPCWSTR    LogFilePath,
  [in]           LCID       Locale,
  [in]           DWORD      Flags
);

Paramètres

[in, optional] Session

Handle de session à distance que la fonction EvtOpenSession retourne. Définissez la valeur NULL pour obtenir les métadonnées d’un fournisseur sur l’ordinateur local.

[in] PublisherId

Nom du fournisseur. Pour énumérer les noms des fournisseurs inscrits sur l’ordinateur, appelez la fonction EvtOpenPublisherEnum .

[in, optional] LogFilePath

Chemin complet d’un fichier journal archivé qui contient les événements enregistrés par le fournisseur. Un fichier journal archivé contient également les métadonnées du fournisseur. Utilisez ce paramètre lorsque le fournisseur n’est pas inscrit sur l’ordinateur local. Définissez la valeur NULL lors de la lecture des métadonnées à partir d’un fournisseur inscrit..

[in] Locale

Identificateur de paramètres régionaux à utiliser lors de l’accès aux métadonnées localisées à partir du fournisseur. Pour créer l’identificateur de paramètres régionaux, utilisez la macro MAKELCID. Définissez sur 0 pour utiliser l’identificateur de paramètres régionaux du thread appelant.

[in] Flags

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

Valeur retournée

Si elle réussit, la fonction retourne un handle aux métadonnées du fournisseur ; sinon, NULL. Si la valeur est NULL, appelez la fonction GetLastError pour obtenir le code d’erreur.

Remarques

Si vous spécifiez un fichier journal archivé, cette fonction case activée pour les métadonnées du fournisseur spécifié dans le fichier journal. Si les métadonnées du fournisseur sont introuvables dans le fichier journal, la fonction recherche le fournisseur dans la liste des fournisseurs inscrits sur l’ordinateur local.

Pour lire les métadonnées du fournisseur, appelez la fonction EvtGetPublisherMetadataProperty . Pour énumérer les événements que le fournisseur définit, appelez la fonction EvtOpenEventMetadataEnum .

Vous devez appeler la fonction EvtClose pour fermer le handle de métadonnées lorsque vous avez terminé.

Exemples

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

Configuration requise


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

EvtGetPublisherMetadataProperty

EvtOpenEventMetadataEnum

EvtOpenPublisherEnum

Partager via