Fungsi TdhEnumerateProviderFilters (tdh.h)

Artikel
03/02/2024

Fungsi TdhEnumerateProviderFilters menghitung filter yang ditentukan penyedia dalam manifes.

Sintaks

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 yang mengidentifikasi penyedia yang filternya ingin Anda ambil.

[in] TdhContextCount

Tidak digunakan.

[in, optional] TdhContext

Tidak digunakan.

[in] FilterCount

Jumlah struktur filter yang dimuat buffer pBuffer . Adalah nol jika buffer pBuffer tidak mencukupi.

[out, optional] Buffer

Buffer yang dialokasikan pengguna untuk menerima informasi filter. Untuk detailnya, lihat struktur PROVIDER_FILTER_INFO .

[in, out] BufferSize

Ukuran, dalam byte, dari buffer pBuffer . Jika fungsi berhasil, parameter ini menerima ukuran buffer yang digunakan. Jika buffer terlalu kecil, fungsi mengembalikan ERROR_INSUFFICIENT_BUFFER dan mengatur parameter ini ke ukuran buffer yang diperlukan. Jika ukuran buffer nol pada input, tidak ada data yang dikembalikan dalam buffer dan parameter ini menerima ukuran buffer yang diperlukan.

Nilai kembali

Mengembalikan ERROR_SUCCESS jika berhasil. Jika tidak, fungsi ini mengembalikan salah satu kode pengembalian berikut selain yang lain.

Menampilkan kode	Deskripsi
ERROR_INSUFFICIENT_BUFFER	Ukuran buffer pBuffer terlalu kecil. Gunakan set ukuran buffer yang diperlukan di pBufferSize untuk mengalokasikan buffer baru.
ERROR_NOT_FOUND	Skema untuk kejadian tidak ditemukan.
ERROR_INVALID_PARAMETER	Satu atau beberapa parameter tidak valid.
ERROR_FILE_NOT_FOUND	Atribut resourceFileName dalam manifes berisi lokasi biner penyedia. Saat Anda mendaftarkan manifes, lokasi ditulis ke registri. TDH tidak dapat menemukan biner berdasarkan lokasi terdaftar.

Keterangan

Fungsi ini menggunakan manifes XML untuk mengambil informasi.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows 7 [hanya aplikasi desktop]
Server minimum yang didukung	Windows Server 2008 R2 [hanya aplikasi desktop]
Target Platform	Windows
Header	tdh.h
Pustaka	Tdh.lib
DLL	Tdh.dll

Bagikan melalui