Función TdhEnumerateProviders (tdh.h)
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 |