Funzione TdhGetManifestEventInformation (tdh.h)

  • Articolo

La funzione TdhGetManifestEventInformation recupera i metadati relativi a un evento in un manifesto.

Sintassi

TDHSTATUS TdhGetManifestEventInformation(
  [in]      LPGUID            ProviderGuid,
  [in]      PEVENT_DESCRIPTOR EventDescriptor,
  [out]     PTRACE_EVENT_INFO Buffer,
  [in, out] ULONG             *BufferSize
);

Parametri

[in] ProviderGuid

GUID che identifica il provider manifesto i cui metadati di evento si desidera recuperare.

[in] EventDescriptor

Puntatore al descrittore dell'evento che contiene informazioni quali ID evento, versione, codice op e parola chiave. Per informazioni dettagliate, vedere la struttura EVENT_DESCRIPTOR

[out] Buffer

Buffer allocato dall'utente per ricevere i metadati relativi a un evento in un manifesto del provider. Per informazioni dettagliate, vedere la struttura TRACE_EVENT_INFO .

[in, out] BufferSize

Dimensioni, in byte, del buffer a cui fa riferimento il parametro Buffer . Se la funzione ha esito positivo, questo parametro riceve le dimensioni del buffer usato. Se il buffer è troppo piccolo, la funzione restituisce ERROR_INSUFFICIENT_BUFFER e imposta questo parametro sulla dimensione del buffer necessaria. Se la dimensione del buffer è zero in input, nessun dato viene restituito nel buffer e questo parametro riceve le dimensioni del buffer necessarie.

Valore restituito

Restituisce ERROR_SUCCESS se riuscito. In caso contrario, questa funzione restituisce uno dei codici restituiti seguenti oltre ad altri.

Codice restituito Descrizione
ERROR_EMPTY
 Nel manifesto non sono stati definiti eventi per il GUID del provider.
ERROR_FILE_NOT_FOUND
 I metadati per il provider non sono stati trovati.
ERROR_INSUFFICIENT_BUFFER
 La dimensione del buffer a cui punta il parametro Buffer è troppo piccola. Usare il set di dimensioni del buffer richiesto nel parametro BufferSize per allocare un nuovo buffer.
ERROR_INVALID_PARAMETER
 Uno o più parametri non sono validi.
ERROR_NOT_FOUND
 Non sono state trovate le informazioni sullo schema per il GUID del provider fornito.

Requisiti

Requisito Valore
Client minimo supportato Windows 8.1 [solo app desktop]
Server minimo supportato Windows Server 2012 R2 [solo app desktop]
Piattaforma di destinazione Windows
Intestazione tdh.h
Libreria Tdh.lib
DLL Tdh.dll

Vedi anche

EVENT_DESCRIPTOR

PROVIDER_EVENT_INFO

TRACE_EVENT_INFO

TdhEnumerateManifestProviderEvents