Share via

Función TdhEnumerateProviders (tdh.h)

  • Artículo

Recupera una lista de todos los proveedores que se han registrado en el equipo.

Sintaxis

TDHSTATUS TdhEnumerateProviders(
  [out]     PPROVIDER_ENUMERATION_INFO pBuffer,
  [in, out] ULONG                      *pBufferSize
);

Parámetros

[out] pBuffer

Matriz de proveedores que definen públicamente sus eventos en el equipo. Para obtener más información, consulte la estructura de PROVIDER_ENUMERATION_INFO .

[in, out] pBufferSize

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_INVALID_PARAMETER Uno o varios de los parámetros no son válidos.

Comentarios

Llame a la función TdhEnumerateProvidersForDecodingSource para recuperar una lista de proveedores que han registrado un archivo de manifiesto o clase MOF en el equipo.

Dado que el número de proveedores de eventos registrados puede fluctuar entre las llamadas a esta función, debe colocar esta función en un bucle que se repite hasta que el valor devuelto ya no se ERROR_INSUFFICIENT_BUFFER.

Ejemplos

Para obtener un ejemplo que muestra cómo enumerar proveedores, vea Enumerar proveedores.

Requisitos

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

Consulte también

TdhEnumerateProviderFieldInformation