TdhGetEventMapInformation-Funktion (tdh.h)

  • Artikel

Ruft Informationen über die im Ereignis enthaltene Ereigniszuordnung ab.

Syntax

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

Parameter

[in] pEvent

Der an Ihren EventRecordCallback-Rückruf übergebene Ereignisdatensatz. Weitere Informationen finden Sie in der EVENT_RECORD-Struktur .

[in] pMapName

Mit Null beendete Unicode-Zeichenfolge, die den Namen des Zuordnungsattributwerts enthält. Der Name stammt aus dem MapNameOffset-Element der EVENT_PROPERTY_INFO-Struktur .

[out] pBuffer

Vom Benutzer zugewiesener Puffer zum Empfangen der Ereigniszuordnung. Bei der Zuordnung kann es sich um eine Wert-, Bitmap- oder Musterzuordnung handeln. Weitere Informationen finden Sie in der EVENT_MAP_INFO-Struktur .

[in, out] pBufferSize

Größe des pBuffer-Puffers in Bytes. Wenn die Funktion erfolgreich ist, empfängt dieser Parameter die Größe des verwendeten Puffers. Wenn der Puffer zu klein ist, gibt die Funktion ERROR_INSUFFICIENT_BUFFER zurück und legt diesen Parameter auf die erforderliche Puffergröße fest. Wenn die Puffergröße bei der Eingabe null ist, werden keine Daten im Puffer zurückgegeben, und dieser Parameter empfängt die erforderliche Puffergröße.

Rückgabewert

Gibt bei erfolgreicher Ausführung ERROR_SUCCESS zurück. Andernfalls gibt diese Funktion zusätzlich zu anderen einen der folgenden Rückgabecodes zurück.

Rückgabecode Beschreibung
ERROR_INSUFFICIENT_BUFFER
 Die Größe des pBuffer-Puffers ist zu klein. Verwenden Sie die erforderliche Puffergröße, die in pBufferSize festgelegt ist, um einen neuen Puffer zuzuweisen.
ERROR_NOT_FOUND
 Das Schema für das Ereignis wurde nicht gefunden, oder die angegebene Zuordnung wurde nicht gefunden.
ERROR_FILE_NOT_FOUND
 Das resourceFileName-Attribut im Manifest enthält den Speicherort der Anbieterbinärdatei. Wenn Sie das Manifest registrieren, wird der Speicherort in die Registrierung geschrieben. TDH konnte die Binärdatei basierend auf dem registrierten Speicherort nicht finden.
ERROR_INVALID_PARAMETER
 Mindestens einer der Parameter ist ungültig.
ERROR_WMI_SERVER_UNAVAILABLE
 Der WMI-Dienst ist nicht verfügbar.

Hinweise

Sie können diese Funktion nicht verwenden, um Ereigniszuordnungsinformationen für WPP-Ereignisse abzurufen.

Bei zuordnungen, die in einem Manifest definiert sind, enthält die Zeichenfolge ein Leerzeichen am Ende der Zeichenfolge. Wenn der Wert beispielsweise "Monday" im Manifest zugeordnet ist, wird die Zeichenfolge als "Monday" zurückgegeben.

Beispiele

Ein Beispiel zum Aufrufen dieser Funktion finden Sie unter Verwenden von TdhGetProperty zum Nutzen von Ereignisdaten.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Windows Vista [nur Desktop-Apps]
Unterstützte Mindestversion (Server) Windows Server 2008 [nur Desktop-Apps]
Zielplattform Windows
Kopfzeile tdh.h
Bibliothek Tdh.lib
DLL Tdh.dll