TdhEnumerateProviderFilters-Funktion (tdh.h)

  • Artikel

Die TdhEnumerateProviderFilters-Funktion listet die Filter auf, die der angegebene Anbieter im Manifest definiert hat.

Syntax

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

Parameter

[in] Guid

GUID, die den Anbieter identifiziert, dessen Filter Sie abrufen möchten.

[in] TdhContextCount

Nicht verwendet.

[in, optional] TdhContext

Nicht verwendet.

[in] FilterCount

Die Anzahl der Filterstrukturen, die der pBuffer-Puffer enthält. Ist null, wenn der pBuffer-Puffer nicht ausreicht.

[out, optional] Buffer

Benutzerseitig zugewiesener Puffer, um die Filterinformationen zu empfangen. Ausführliche Informationen finden Sie in der PROVIDER_FILTER_INFO-Struktur .

[in, out] BufferSize

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_NOT_FOUND
 Das Schema für das Ereignis wurde nicht gefunden.
ERROR_INVALID_PARAMETER
 Mindestens ein Parameter ist ungültig.
ERROR_FILE_NOT_FOUND
 Das resourceFileName-Attribut im Manifest enthält den Speicherort der Anbieterbinärdatei. Wenn Sie das Manifest registrieren, wird der Speicherort in die Registrierung geschrieben. TDH konnte die Binärdatei nicht basierend auf dem registrierten Speicherort finden.

Hinweise

Diese Funktion verwendet das XML-Manifest, um die Informationen abzurufen.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Windows 7 [nur Desktop-Apps]
Unterstützte Mindestversion (Server) Windows Server 2008 R2 [nur Desktop-Apps]
Zielplattform Windows
Kopfzeile tdh.h
Bibliothek Tdh.lib
DLL Tdh.dll