Función TdhEnumerateProviderFilters (tdh.h)

  • Artículo

La función TdhEnumerateProviderFilters enumera los filtros que el proveedor especificado definió en el manifiesto.

Sintaxis

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
);

Parámetros

[in] Guid

GUID que identifica el proveedor cuyos filtros desea recuperar.

[in] TdhContextCount

No se utiliza.

[in, optional] TdhContext

No se utiliza.

[in] FilterCount

Número de estructuras de filtro que contiene el búfer de pBuffer . Es cero si el búfer de pBuffer no es suficiente.

[out, optional] Buffer

Búfer asignado por el usuario para recibir la información de filtro. Para obtener más información, consulte la estructura PROVIDER_FILTER_INFO .

[in, out] BufferSize

Tamaño, en bytes, del búfer de pBuffer . Si la función se realiza correctamente, este parámetro recibe el tamaño del búfer usado. Si el búfer es demasiado pequeño, la función devuelve ERROR_INSUFFICIENT_BUFFER y establece este parámetro en el tamaño de búfer necesario. Si el tamaño del búfer es cero en la entrada, no se devuelve ningún dato en el búfer y este parámetro recibe el tamaño de búfer necesario.

Valor devuelto

Devuelve ERROR_SUCCESS si se ejecuta correctamente. De lo contrario, esta función devuelve uno de los siguientes códigos de retorno además de otros.

Código devuelto Descripción
ERROR_INSUFFICIENT_BUFFER
 El tamaño del búfer de pBuffer es demasiado pequeño. Use el tamaño de búfer necesario establecido en pBufferSize para asignar un nuevo búfer.
ERROR_NOT_FOUND
 No se encontró el esquema del evento.
ERROR_INVALID_PARAMETER
 Uno o varios de los parámetros no son válidos.
ERROR_FILE_NOT_FOUND
 El atributo resourceFileName del manifiesto contiene la ubicación del binario del proveedor. Al registrar el manifiesto, la ubicación se escribe en el Registro. TDH no pudo encontrar el binario en función de la ubicación registrada.

Comentarios

Esta función usa el manifiesto XML para recuperar la información.

Requisitos

Requisito Value
Cliente mínimo compatible Windows 7 [solo aplicaciones de escritorio]
Servidor mínimo compatible Windows Server 2008 R2 [solo aplicaciones de escritorio]
Plataforma de destino Windows
Encabezado tdh.h
Library Tdh.lib
Archivo DLL Tdh.dll