Funzione TdhEnumerateProviderFilters (tdh.h)

Articolo
08/26/2023

La funzione TdhEnumerateProviderFilters enumera i filtri definiti dal provider specificato nel manifesto.

Sintassi

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

Parametri

[in] Guid

GUID che identifica il provider i cui filtri si desidera recuperare.

[in] TdhContextCount

Non usato.

[in, optional] TdhContext

Non usato.

[in] FilterCount

Numero di strutture di filtro contenute nel buffer pBuffer . È zero se il buffer pBuffer non è sufficiente.

[out, optional] Buffer

Buffer allocato dall'utente per ricevere le informazioni sul filtro. Per informazioni dettagliate, vedere la struttura PROVIDER_FILTER_INFO .

[in, out] BufferSize

Dimensioni, in byte, del buffer pBuffer . Se la funzione ha esito positivo, questo parametro riceve le dimensioni del buffer usato. Se il buffer è troppo piccolo, la funzione restituisce ERROR_INSUFFICIENT_BUFFER e imposta questo parametro sulla dimensione del buffer necessaria. Se la dimensione del buffer è zero in input, nessun dato viene restituito nel buffer e questo parametro riceve le dimensioni del buffer necessarie.

Valore restituito

Restituisce ERROR_SUCCESS se riuscito. In caso contrario, questa funzione restituisce uno dei codici restituiti seguenti oltre ad altri.

Codice restituito	Descrizione
ERROR_INSUFFICIENT_BUFFER	Le dimensioni del buffer pBuffer sono troppo piccole. Usare il set di dimensioni del buffer richiesto in pBufferSize per allocare un nuovo buffer.
ERROR_NOT_FOUND	Lo schema per l'evento non è stato trovato.
ERROR_INVALID_PARAMETER	Uno o più parametri non sono validi.
ERROR_FILE_NOT_FOUND	L'attributo resourceFileName nel manifesto contiene il percorso del file binario del provider. Quando si registra il manifesto, il percorso viene scritto nel Registro di sistema. TDH non è riuscito a trovare il file binario in base alla posizione registrata.

Commenti

Questa funzione usa il manifesto XML per recuperare le informazioni.

Requisiti

Requisito	Valore
Client minimo supportato	Windows 7 [solo app desktop]
Server minimo supportato	Windows Server 2008 R2 [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	tdh.h
Libreria	Tdh.lib
DLL	Tdh.dll

Condividi tramite