Функция TdhGetEventMapInformation (tdh.h)

  • Статья

Извлекает сведения о карте событий, содержащейся в событии.

Синтаксис

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

Параметры

[in] pEvent

Запись события, переданная обратному вызову EventRecordCallback . Дополнительные сведения см . в EVENT_RECORD структуре.

[in] pMapName

Строка Юникода, заканчивающаяся null, которая содержит имя значения атрибута карты. Имя происходит от элемента MapNameOffsetструктуры EVENT_PROPERTY_INFO .

[out] pBuffer

Выделенный пользователем буфер для получения карты событий. Карта может быть картой значений, точечным рисунком или картой шаблонов. Дополнительные сведения см. в разделе структура EVENT_MAP_INFO .

[in, out] pBufferSize

Размер буфера pBuffer (в байтах). Если функция выполняется успешно, этот параметр получает размер используемого буфера. Если буфер слишком мал, функция возвращает ERROR_INSUFFICIENT_BUFFER и задает для этого параметра требуемый размер буфера. Если размер буфера равен нулю при входных данных, данные в буфере не возвращаются, и этот параметр получает требуемый размер буфера.

Возвращаемое значение

В случае успешного выполнения возвращает ERROR_SUCCESS. В противном случае эта функция возвращает один из следующих кодов возврата в дополнение к другим.

Код возврата Описание
ERROR_INSUFFICIENT_BUFFER
 Размер буфера pBuffer слишком мал. Используйте необходимый размер буфера, заданный в pBufferSize , чтобы выделить новый буфер.
ERROR_NOT_FOUND
 Схема события не найдена или указанная карта не найдена.
ERROR_FILE_NOT_FOUND
 Атрибут resourceFileName в манифесте содержит расположение двоичного файла поставщика. При регистрации манифеста расположение записывается в реестр. TDH не удалось найти двоичный файл на основе зарегистрированного расположения.
ERROR_INVALID_PARAMETER
 Один или несколько параметров недопустимы.
ERROR_WMI_SERVER_UNAVAILABLE
 Служба WMI недоступна.

Комментарии

Эту функцию нельзя использовать для получения сведений о карте событий для событий WPP.

Для карт, определенных в манифесте, строка будет содержать пробел в конце строки. Например, если значение сопоставляется с "Monday" в манифесте, строка возвращается как "Monday".

Примеры

Пример вызова этой функции см. в статье Использование TdhGetProperty для использования данных о событиях.

Требования

Требование Значение
Минимальная версия клиента Windows Vista [только классические приложения]
Минимальная версия сервера Windows Server 2008 [только классические приложения]
Целевая платформа Windows
Header tdh.h
Библиотека Tdh.lib
DLL Tdh.dll