Fungsi WSCInstallQOSTemplate (ws2spi.h)
[ Fungsi ini tidak didukung di Windows Vista dan versi sistem operasi berikutnya.]
Fungsi WSCInstallQOSTemplate menginstal templat QoS yang ditentukan dalam database konfigurasi sistem.
int WSCInstallQOSTemplate(
[in] const LPGUID Guid,
[in] LPWSABUF QosName,
[in] LPQOS Qos
);
[in] Guid
Pengidentifikasi unik global (GUID) untuk penyedia kualitas layanan (QoS).
[in] QosName
Penunjuk ke struktur WSABUF yang berisi nama QoS templat untuk diinstal.
[in] Qos
Penunjuk ke struktur QOS yang menentukan kualitas spesifikasi alur layanan dan informasi khusus penyedia apa pun untuk templat QoS.
Jika fungsi WSCInstallQOSTemplate berhasil, nilai yang dikembalikan adalah nol. Jika tidak, ia mengembalikan salah satu kode kesalahan berikut.
| Kode kesalahan | Makna |
|---|---|
| Satu atau beberapa argumen tidak berada di bagian ruang alamat pengguna yang valid. | |
| Satu atau beberapa argumen tidak valid. Kesalahan ini dikembalikan jika penyedia QoS yang ditentukan dalam parameter Guid tidak valid atau nama templat QoS yang ditentukan dalam parameter QosName tidak valid. Kesalahan ini juga dikembalikan jika konten struktur templat yang ditentukan dalam parameter Qos tidak valid atau tidak lengkap. | |
| Memori tidak dapat dialokasikan untuk buffer. | |
| Terjadi kesalahan yang tidak dapat dipulihkan. Kesalahan ini dikembalikan dalam beberapa kondisi termasuk yang berikut ini: penyedia sudah diinstal, pengguna tidak memiliki hak istimewa administratif yang diperlukan untuk menulis ke registri Winsock, atau kegagalan terjadi saat membuat atau menginstal entri katalog. | |
| Panggilan sistem yang seharusnya tidak pernah gagal gagal. | |
| Memori tidak cukup tersedia. Kesalahan ini dikembalikan ketika memori tidak cukup untuk mengalokasikan entri katalog baru. |
Fungsi WSCInstallQOSTemplate tidak didukung pada Windows Vista dan yang lebih baru. Jika fungsi ini dipanggil pada Windows Vista, dan kesalahan dikembalikan.
Fungsi WSCInstallQOSTemplate menginstal templat QoS, berdasarkan nama QoS. Pemanggil fungsi WSCInstallQOSTemplate harus memiliki hak administratif yang sesuai agar panggilan berhasil.
Struktur QOS yang berisi pengaturan QoS nantinya dapat diambil dengan memanggil fungsi WSPGetQOSByName dan meneruskan nama QoS terkait.
Fungsi WSCInstallQOSTemplate menginstal templat bernama QoS yang berisi
Struktur QOS ditentukan dalam parameter Qos . Jika templat QoS sudah ada dengan nama QoS yang ditentukan dalam parameter Qosname , pengaturan yang ditentukan dalam parameter Qos menggantikan pengaturan templat yang ada.
Jika parameter Guid diatur ke NULL, templat QOS yang diinstal berlaku untuk semua penyedia layanan. Jika parameter Guid bukan NULL, maka templat QoS yang diinstal hanya berlaku untuk penyedia yang ditunjukkan oleh parameter Guid .
Pengaturan templat QoS disimpan dalam penyimpanan nonvolatile, sehingga panggilan berikutnya ke fungsi WSAGetQOSByName dengan nama QoS yang sama yang ditentukan dalam parameter lpQOSName , mengembalikan struktur QOS yang sama yang diteruskan ke fungsi WSCInstallQOSTemplate .
Windows Sockets 2 menyertakan sekumpulan dasar templat QoS. Anda dapat mengganti dan mengganti salah satu templat QoS ini atau mengubah templat QoS yang ada hanya dengan menginstal templat baru dengan nama yang ada. Anda tidak perlu menghapus templat yang ada sebelum mengganti atau mengubahnya. Anda tidak dapat menghapus kumpulan dasar templat bernama QoS yang disertakan dalam Windows Sockets 2. Namun, Anda dapat menghapus templat yang ditambahkan kemudian, mungkin oleh penyedia layanan lain.
Parameter Qos menunjuk ke struktur QOS yang dapat menyertakan buffer yang berisi pengaturan khusus penyedia di anggota ProviderSpecific dari struktur QOS . Pengaturan khusus penyedia apa pun disimpan dengan struktur QOS dasar dan dikembalikan dalam panggilan berikutnya ke fungsi WSAGetQOSByName .
Anggota ProviderSpecific struktur QOS dapat diatur meskipun parameter Guid diatur ke NULL untuk menginstal templat QoS global untuk semua penyedia layanan. Perhatikan bahwa praktik ini dapat menyebabkan penyedia layanan mengabaikan anggota ProviderSpecific dari struktur QOS jika penyedia layanan tidak mengenali kontennya. Penggunaan fungsi WSCInstallQOSTemplate yang direkomendasikan adalah menyertakan pengaturan khusus penyedia dalam anggota ProviderSpecific dari struktur QOS hanya jika templat bernama sedang diinstal pada penyedia layanan tertentu (parameter Guid bukan NULL).
| Persyaratan | Nilai |
|---|---|
| Klien minimum yang didukung | Windows 2000 Professional [hanya aplikasi desktop] |
| Server minimum yang didukung | Windows 2000 Server [hanya aplikasi desktop] |
| Target Platform | Windows |
| Header | ws2spi.h |