Поделиться через

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

  • Статья

Функция TdhEnumerateProviderFilters перечисляет фильтры, определенные указанным поставщиком в манифесте.

Синтаксис

TDHSTATUS TdhEnumerateProviderFilters(
  [in]            LPGUID                Guid,
  [in]            ULONG                 TdhContextCount,
  [in, optional]  PTDH_CONTEXT          TdhContext,
  [in]            ULONG                 *FilterCount,
  [out, optional] PPROVIDER_FILTER_INFO *Buffer,
  [in, out]       ULONG                 *BufferSize
);

Параметры

[in] Guid

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

[in] TdhContextCount

Не используется.

[in, optional] TdhContext

Не используется.

[in] FilterCount

Количество структур фильтров, содержащихся в буфере pBuffer . Равно нулю, если буфера pBuffer недостаточно.

[out, optional] Buffer

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

[in, out] BufferSize

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

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

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

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

Комментарии

Эта функция использует XML-манифест для получения сведений.

Требования

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