Fungsi TcEnumerateInterfaces (traffic.h)

Fungsi TcEnumerateInterfaces menghitung semua antarmuka jaringan yang mendukung kontrol lalu lintas. Klien diberi tahu tentang perubahan antarmuka melalui fungsi ClNotifyHandler .

Syntax

ULONG TcEnumerateInterfaces(
  [in]      HANDLE             ClientHandle,
  [in, out] PULONG             pBufferSize,
  [out]     PTC_IFC_DESCRIPTOR InterfaceBuffer
);

Parameter-parameternya

[in] ClientHandle

Tangani yang digunakan oleh kontrol lalu lintas untuk mengidentifikasi klien. Klien menerima handel saat mendaftar dengan kontrol lalu lintas melalui fungsi TcRegisterClient .

[in, out] pBufferSize

Penunjuk ke nilai yang menunjukkan ukuran buffer. Untuk input, nilai ini adalah ukuran buffer, dalam byte, yang dialokasikan oleh pemanggil. Untuk output, nilai ini adalah ukuran aktual buffer, dalam byte, digunakan atau diperlukan oleh kontrol lalu lintas. Nilai nol pada output menunjukkan bahwa tidak ada antarmuka kontrol lalu lintas yang tersedia, yang menunjukkan bahwa Penjadwal Paket QOS tidak diinstal.

[out] InterfaceBuffer

Penunjuk ke buffer yang berisi daftar deskriptor antarmuka yang dikembalikan.

Mengembalikan nilai

Penyelesaian berhasil mengembalikan nama perangkat antarmuka.

Mengembalikan kode	Description
NO_ERROR	Fungsi dijalankan tanpa kesalahan.
ERROR_INVALID_HANDLE	Handel klien tidak valid.
ERROR_INVALID_PARAMETER	Salah satu parameternya adalah NULL.
ERROR_INSUFFICIENT_BUFFER	Buffer terlalu kecil untuk menghitung semua antarmuka. Jika kesalahan ini dikembalikan, ukuran buffer yang benar (diperlukan) diteruskan kembali dalam pBufferSize.
ERROR_NOT_ENOUGH_MEMORY	Sistem kehabisan memori.

Komentar

Klien yang memanggil fungsi TcEnumerateInterfaces harus terlebih dahulu mengalokasikan buffer, lalu meneruskan buffer ke kontrol lalu lintas melalui InterfaceBuffer. Kontrol lalu lintas mengembalikan penunjuk ke array deskriptor antarmuka di InterfaceBuffer. Setiap deskriptor antarmuka berisi dua elemen:

• Antarmuka kontrol lalu lintas mengidentifikasi string teks.
• Deskriptor daftar alamat jaringan yang saat ini terkait dengan antarmuka.

Deskriptor daftar alamat jaringan mencakup jenis media, serta daftar alamat jaringan. Jenis media menentukan bagaimana daftar alamat jaringan harus ditafsirkan:

• Untuk media tanpa koneksi seperti LAN, daftar alamat jaringan berisi semua alamat khusus protokol yang terkait dengan antarmuka.
• Untuk media berorientasi koneksi seperti WAN, daftar alamat jaringan berisi jumlah alamat jaringan yang merata:
  • Alamat pertama di setiap pasangan mewakili alamat lokal (sumber) antarmuka.
  • Alamat kedua di setiap pasangan mewakili alamat antarmuka jarak jauh (tujuan).

Nota Penggunaan fungsi TcEnumerateInterfaces memerlukan hak istimewa administratif.

 

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows 2000 Professional [hanya aplikasi desktop]
Server minimum yang didukung	Windows 2000 Server [hanya aplikasi desktop]
Platform Target	Windows
Header	traffic.h
Library	Traffic.lib
DLL	Traffic.dll

Lihat juga

ClNotifyHandler

TcRegisterClient