TdhEnumerateProviders-Funktion (tdh.h)

  • Artikel

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

Weitere Informationen

TdhEnumerateProviderFieldInformation