TdhEnumerateProviders-Funktion (tdh.h)
Ruft eine Liste aller Anbieter ab, die sich auf dem Computer registriert haben.
Syntax
TDHSTATUS TdhEnumerateProviders(
[out] PPROVIDER_ENUMERATION_INFO pBuffer,
[in, out] ULONG *pBufferSize
);
Parameter
[out] pBuffer
Array von Anbietern, die ihre Ereignisse auf dem Computer öffentlich definieren. Ausführliche Informationen finden Sie in der PROVIDER_ENUMERATION_INFO-Struktur .
[in, out] pBufferSize
Größe des pBuffer-Puffers in Bytes. Wenn die Funktion erfolgreich ist, empfängt dieser Parameter die Größe des verwendeten Puffers. Wenn der Puffer zu klein ist, gibt die Funktion ERROR_INSUFFICIENT_BUFFER zurück und legt diesen Parameter auf die erforderliche Puffergröße fest. Wenn die Puffergröße bei der Eingabe null ist, werden keine Daten im Puffer zurückgegeben, und dieser Parameter empfängt die erforderliche Puffergröße.
Rückgabewert
Gibt bei erfolgreicher Ausführung ERROR_SUCCESS zurück. Andernfalls gibt diese Funktion zusätzlich zu anderen einen der folgenden Rückgabecodes zurück.
| Rückgabecode | Beschreibung |
|---|---|
| ERROR_INSUFFICIENT_BUFFER | Die Größe des pBuffer-Puffers ist zu klein. Verwenden Sie die erforderliche Puffergröße, die in pBufferSize festgelegt ist, um einen neuen Puffer zuzuweisen. |
| ERROR_INVALID_PARAMETER | Mindestens ein Parameter ist ungültig. |
Hinweise
Rufen Sie die TdhEnumerateProvidersForDecodingSource-Funktion auf, um eine Liste der Anbieter abzurufen, die eine MOF-Klasse oder -Manifestdatei auf dem Computer registriert haben.
Da die Anzahl der registrierten Ereignisanbieter zwischen aufrufen dieser Funktion schwanken kann, sollten Sie diese Funktion in einer Schleife platzieren, die schleift, bis der zurückgegebene Wert nicht mehr ERROR_INSUFFICIENT_BUFFER ist.
Beispiele
Ein Beispiel, das zeigt, wie Anbieter aufgezählt werden, finden Sie unter Aufzählen von Anbietern.
Anforderungen
| Unterstützte Mindestversion (Client) | Windows Vista [nur Desktop-Apps] |
| Unterstützte Mindestversion (Server) | Windows Server 2008 [nur Desktop-Apps] |
| Zielplattform | Windows |
| Kopfzeile | tdh.h |
| Bibliothek | Tdh.lib |
| DLL | Tdh.dll |