Funzione EvtOpenPublisherMetadata (winevt.h)

Ottiene un handle utilizzato per leggere i metadati del provider specificato.

Sintassi

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

Parametri

[in, optional] Session

Handle di sessione remota restituito dalla funzione EvtOpenSession . Impostare su NULL per ottenere i metadati per un provider nel computer locale.

[in] PublisherId

Nome del provider. Per enumerare i nomi dei provider registrati nel computer, chiamare la funzione EvtOpenPublisherEnum .

[in, optional] LogFilePath

Percorso completo di un file di log archiviato che contiene gli eventi registrati dal provider. Un file di log archiviato contiene anche i metadati del provider. Utilizzare questo parametro quando il provider non è registrato nel computer locale. Impostare su NULL durante la lettura dei metadati da un provider registrato.

[in] Locale

Identificatore delle impostazioni locali da utilizzare per l'accesso ai metadati localizzati dal provider. Per creare l'identificatore delle impostazioni locali, utilizzare la macro MAKELCID. Impostare su 0 per usare l'identificatore delle impostazioni locali del thread chiamante.

[in] Flags

Riservato. Deve essere zero.

Valore restituito

In caso di esito positivo, la funzione restituisce un handle ai metadati del provider; in caso contrario, NULL. Se NULL, chiamare la funzione GetLastError per ottenere il codice di errore.

Commenti

Se si specifica un file di log archiviato, questa funzione verificherà la presenza dei metadati del provider specificato nel file di log. Se i metadati del provider non vengono trovati nel file di log, la funzione cercherà il provider nell'elenco dei provider registrati nel computer locale.

Per leggere i metadati del provider, chiamare la funzione EvtGetPublisherMetadataProperty . Per enumerare gli eventi definiti dal provider, chiamare la funzione EvtOpenEventMetadataEnum .

Al termine, è necessario chiamare la funzione EvtClose per chiudere l'handle di metadati.

Esempio

Per un esempio che illustra come usare questa funzione, vedere Recupero dei metadati di un provider.

Requisiti

Vedi anche

EvtGetPublisherMetadataProperty

EvtOpenEventMetadataEnum

EvtOpenPublisherEnum