TdhGetEventMapInformation-Funktion (tdh.h)
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 |
---|---|
|
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. |
|
Das Schema für das Ereignis wurde nicht gefunden, oder die angegebene Zuordnung wurde nicht gefunden. |
|
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. |
|
Mindestens einer der Parameter ist ungültig. |
|
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 |