Fungsi TdhEnumerateProviderFilters (tdh.h)

  • Artikel

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