Fungsi TcModifyFlow (traffic.h)

Fungsi TcModifyFlow memodifikasi alur yang ada. Saat memanggil TcModifyFlow, parameter Flowspec baru dan objek kontrol lalu lintas apa pun harus diisi.

Klien kontrol lalu lintas yang telah mendaftarkan handler ModifyFlowComplete (mekanisme untuk memungkinkan kontrol lalu lintas memanggil fungsi panggilan balik ClModifyFlowComplete untuk memperingatkan klien tentang modifikasi alur yang selesai) dapat mengharapkan nilai pengembalian ERROR_SIGNAL_PENDING.

Sintaks

ULONG TcModifyFlow(
  [in] HANDLE       FlowHandle,
  [in] PTC_GEN_FLOW pGenericFlow
);

Parameter

[in] FlowHandle

Tangani untuk alur, seperti yang diterima dari panggilan sebelumnya ke fungsi TcAddFlow .

[in] pGenericFlow

Penunjuk ke deskripsi modifikasi alur.

Menampilkan nilai

Menampilkan kode Deskripsi
NO_ERROR
 Fungsi dijalankan tanpa kesalahan.
ERROR_SIGNAL_PENDING
 Fungsi sedang dijalankan secara asinkron; klien akan dipanggil kembali melalui fungsi ClModifyFlowComplete yang diekspos klien ketika alur telah ditambahkan, atau ketika proses telah selesai.
ERROR_INVALID_HANDLE
 Handel antarmuka tidak valid.
ERROR_NOT_ENOUGH_MEMORY
 Sistem kehabisan memori.
ERROR_NOT_READY
 Tindakan yang dilakukan pada alur oleh panggilan fungsi sebelumnya ke TcAddFlow, TcModifyFlow, atau TcDeleteFlow belum selesai.
ERROR_INVALID_PARAMETER
 Parameter tidak valid.
ERROR_INVALID_SERVICE_TYPE
 Jenis layanan intserv yang tidak ditentukan atau buruk telah disediakan.
ERROR_INVALID_TOKEN_RATE
 Nilai TokenRate yang tidak ditentukan atau buruk telah disediakan.
ERROR_INVALID_PEAK_RATE
 Nilai PeakBandwidth tidak valid.
ERROR_INVALID_SD_MODE
 ShapeDiscardMode tidak valid.
ERROR_INVALID_QOS_PRIORITY
 Nilai prioritas tidak valid.
ERROR_INVALID_TRAFFIC_CLASS
 Nilai kelas lalu lintas tidak valid.
ERROR_NO_SYSTEM_RESOURCES
 Tidak ada cukup sumber daya untuk mengakomodasi alur yang diminta.
ERROR_TC_OBJECT_LENGTH_INVALID
 Panjang buruk ditentukan untuk objek TC.
ERROR_INVALID_DIFFSERV_FLOW
 Berlaku untuk alur Diffserv. Menunjukkan bahwa objek QOS_DIFFSERV diteruskan dengan parameter yang tidak valid.
ERROR_DS_MAPPING_EXISTS
 Berlaku untuk alur Diffserv. Menunjukkan bahwa QOS_DIFFSERV_RULE yang ditentukan dalam TC_GEN_FLOW sudah berlaku untuk alur yang ada pada antarmuka.
ERROR_INVALID_SHAPE_RATE
 QOS_SHAPING_RATE diteruskan dengan ShapeRate yang tidak valid.
ERROR_INVALID_DS_CLASS

QOS_DS_CLASS tidak valid.
ERROR_NETWORK_UNREACHABLE
 Kabel jaringan tidak dicolokkan ke adaptor.

Keterangan

Jika fungsi TcModifyFlow mengembalikan ERROR_SIGNAL_PENDING, fungsi ClModifyFlowComplete akan dipanggil pada utas yang berbeda dari utas yang disebut fungsi TcModifyFlow .

Catatan Penggunaan fungsi TcModifyFlow memerlukan hak istimewa admin.
 

Persyaratan

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

Lihat juga

ClModifyFlowComplete

TcAddFlow

TcEnumerateFlows

  • Last updated on