Bagikan melalui

Fungsi panggilan balik LPWSPGETQOSBYNAME (ws2spi.h)

  • Artikel

Fungsi WSPGetQOSByName menginisialisasi struktur QOS berdasarkan templat bernama, atau mengambil enumerasi nama templat yang tersedia.

Sintaks

LPWSPGETQOSBYNAME Lpwspgetqosbyname;

BOOL Lpwspgetqosbyname(
  [in]      SOCKET s,
  [in, out] LPWSABUF lpQOSName,
  [out]     LPQOS lpQOS,
  [out]     LPINT lpErrno
)
{...}

Parameter

[in] s

Deskriptor mengidentifikasi soket.

[in, out] lpQOSName

Menentukan nama templat QOS, atau menyediakan buffer untuk mengambil enumerasi nama templat yang tersedia.

[out] lpQOS

Arahkan ke struktur QOS yang akan diisi.

[out] lpErrno

Arahkan ke kode kesalahan.

Mengembalikan nilai

Jika fungsi berhasil, nilai yang dikembalikan adalah TRUE. Jika fungsi gagal, nilai yang dikembalikan adalah FALSE, dan kode kesalahan tertentu tersedia di lpErrno.

Kode Kesalahan Makna
WSAENETDOWN
 Subsistem jaringan gagal.
WSAENOTSOCK
 Deskriptor bukan soket.
WSAENOTSOCK
 Argumen lpQOS bukan bagian yang valid dari ruang alamat pengguna, atau panjang buffer untuk lpQOS terlalu kecil.
WSAEINVAL
 Nama templat QOS yang ditentukan tidak valid.

Keterangan

Klien dapat menggunakan WSPGetQOSByName untuk menginisialisasi struktur QOS ke sekumpulan nilai yang diketahui yang sesuai untuk kelas layanan atau jenis media tertentu. Nilai-nilai ini disimpan dalam templat yang dirujuk oleh nama terkenal. Klien dapat mengambil nilai-nilai ini dengan mengatur anggota bufWSABUF yang ditunjukkan oleh lpQOSName untuk menunjuk ke string Unicode dengan panjang bukan nol yang menentukan nama templat. Dalam hal ini penggunaan lpQOSName hanya IN, dan hasil dikembalikan melalui lpQOS.

Atau, klien dapat menggunakan LPWSPGetQOSByName untuk mengambil enumerasi nama templat yang tersedia. Klien dapat melakukan ini dengan mengatur anggota bufWSABUF yang ditunjukkan oleh lpQOSName ke string Unicode null panjang nol yang dihentikan. Dalam hal ini, buffer yang ditunjukkan oleh buf ditimpa dengan urutan string nama templat Unicode yang dihentikan null sebanyak yang tersedia hingga jumlah byte yang tersedia dalam buf seperti yang ditunjukkan oleh anggota lensaWSABUF yang ditunjukkan oleh lpQOSName. Daftar nama itu sendiri dihentikan oleh string nama Unicode panjang nol. Ketika LPWSPGetQOSByName digunakan untuk mengambil nama templat, parameter lpQOS diabaikan.

Persyaratan

Persyaratan Nilai
Klien minimum yang didukung Windows 2000 Professional [hanya aplikasi desktop]
Server minimum yang didukung Windows 2000 Server [hanya aplikasi desktop]
Header ws2spi.h

Lihat juga

LPWSPAccept

LPWSPConnect

LPWSPGetSockopt