Fungsi TdhEnumerateProviders (tdh.h)

Mengambil daftar semua penyedia yang telah terdaftar di komputer.

Sintaks

TDHSTATUS TdhEnumerateProviders(
  [out]     PPROVIDER_ENUMERATION_INFO pBuffer,
  [in, out] ULONG                      *pBufferSize
);

Parameter

[out] pBuffer

Array penyedia yang secara publik menentukan peristiwa mereka di komputer. Untuk detailnya, lihat struktur PROVIDER_ENUMERATION_INFO .

[in, out] pBufferSize

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_INVALID_PARAMETER	Satu atau beberapa parameter tidak valid.

Keterangan

Panggil fungsi TdhEnumerateProvidersForDecodingSource untuk mengambil daftar penyedia yang telah mendaftarkan kelas MOF atau file manifes di komputer.

Karena jumlah penyedia peristiwa terdaftar mungkin berfluktuasi antara panggilan ke fungsi ini, Anda harus menempatkan fungsi ini dalam perulangan yang mengulang hingga nilai yang dikembalikan tidak lagi ERROR_INSUFFICIENT_BUFFER.

Contoh

Untuk contoh yang menunjukkan cara menghitung penyedia, lihat Menghitung Penyedia.

Persyaratan

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

Lihat juga

TdhEnumerateProviderFieldInformation