Funzione TdhGetEventMapInformation (tdh.h)

Articolo
08/26/2023

Recupera informazioni sulla mappa eventi contenuta nell'evento.

Sintassi

TDHSTATUS TdhGetEventMapInformation(
  [in]      PEVENT_RECORD   pEvent,
  [in]      PWSTR           pMapName,
  [out]     PEVENT_MAP_INFO pBuffer,
  [in, out] ULONG           *pBufferSize
);

Parametri

[in] pEvent

Record dell'evento passato al callback EventRecordCallback . Per informazioni dettagliate, vedere la struttura EVENT_RECORD .

[in] pMapName

Stringa Unicode con terminazione Null contenente il nome del valore dell'attributo map. Il nome deriva dal membro MapNameOffset della struttura EVENT_PROPERTY_INFO .

[out] pBuffer

Buffer allocato dall'utente per ricevere la mappa eventi. La mappa può essere una mappa dei valori, una bitmap o una mappa dei criteri. Per informazioni dettagliate, vedere la struttura EVENT_MAP_INFO .

[in, out] pBufferSize

Dimensioni, in byte, del buffer pBuffer . 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 sulle dimensioni del buffer necessarie. Se la dimensione del buffer è zero nell'input, nel buffer non vengono restituiti dati e questo parametro riceve le dimensioni del buffer necessarie.

Valore restituito

Restituisce ERROR_SUCCESS in caso di esito positivo. In caso contrario, questa funzione restituisce uno dei codici restituiti seguenti oltre ad altri.

Codice restituito	Descrizione
ERROR_INSUFFICIENT_BUFFER	Le dimensioni del buffer pBuffer sono troppo piccole. Usare il set di dimensioni del buffer richiesto in pBufferSize per allocare un nuovo buffer.
ERROR_NOT_FOUND	Lo schema per l'evento non è stato trovato o la mappa specificata non è stata trovata.
ERROR_FILE_NOT_FOUND	L'attributo resourceFileName nel manifesto contiene il percorso del file binario del provider. Quando si registra il manifesto, il percorso viene scritto nel Registro di sistema. TDH non è riuscito a trovare il file binario in base alla posizione registrata.
ERROR_INVALID_PARAMETER	Uno o più parametri non sono validi.
ERROR_WMI_SERVER_UNAVAILABLE	Il servizio WMI non è disponibile.

Commenti

Non è possibile utilizzare questa funzione per recuperare le informazioni sulla mappa eventi per gli eventi WPP.

Per le mappe definite in un manifesto, la stringa conterrà uno spazio alla fine della stringa. Ad esempio, se il valore viene mappato a "Monday" nel manifesto, la stringa viene restituita come "Monday".

Esempio

Per un esempio che illustra come chiamare questa funzione, vedere Using TdhGetProperty to Consume Event Data .For an example that shows how to call this function, see Using TdhGetProperty to Consume Event Data.

Requisiti

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

Condividi tramite