Поделиться через

Функция обратного вызова LPWSPGETQOSBYNAME (ws2spi.h)

  • Статья

Функция WSPGetQOSByName инициализирует структуру QOS на основе именованного шаблона или извлекает перечисление доступных имен шаблонов.

Синтаксис

LPWSPGETQOSBYNAME Lpwspgetqosbyname;

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

Параметры

[in] s

Дескриптор, определяющий сокет.

[in, out] lpQOSName

Указывает имя шаблона QOS или предоставляет буфер для получения перечисления доступных имен шаблонов.

[out] lpQOS

Указатель на заполняемую структуру QOS .

[out] lpErrno

Указатель на код ошибки.

Возвращаемое значение

Если функция выполнена успешно, возвращается значение TRUE. Если функция завершается сбоем, возвращается значение FALSE, а в lpErrno доступен определенный код ошибки.

Код ошибки Значение
WSAENETDOWN
 Произошел сбой сетевой подсистемы.
WSAENOTSOCK
 Дескриптор не является сокетом.
WSAENOTSOCK
 Аргумент lpQOS не является допустимой частью адресного пространства пользователя или длина буфера для lpQOS слишком мала.
WSAEINVAL
 Указанное имя шаблона QOS является недопустимым.

Комментарии

Клиенты могут использовать WSPGetQOSByName для инициализации структуры QOS набором известных значений, подходящих для определенного класса службы или типа мультимедиа. Эти значения хранятся в шаблоне, на который ссылается хорошо известное имя. Клиент может получить эти значения, задав член bufWSABUF , указанный lpQOSName , чтобы он указывал на строку Юникода ненулевой длины, указывающую имя шаблона. В этом случае используется только lpQOSName , а результаты возвращаются через lpQOS.

Кроме того, клиент может использовать LPWSPGetQOSByName для получения перечисления доступных имен шаблонов. Клиент может сделать это, задав для элемента BUFWSABUF , указанного lpQOSName , нулевую строку Юникода, завершаемую нулевым значением. В этом случае буфер, указанный buf , перезаписывается последовательностью из числа строк имен шаблонов Юникода, заканчивающихся nullом, вплоть до количества байтов, доступных в buf , как указано элементом lenWSABUF, указанным lpQOSName. Сам список имен завершается строкой имени Юникода нулевой длины. Если для получения имен шаблонов используется LPWSPGetQOSByName , параметр lpQOS игнорируется.

Требования

Требование Значение
Минимальная версия клиента Windows 2000 Professional [только классические приложения]
Минимальная версия сервера Windows 2000 Server [только классические приложения]
Верхняя часть ws2spi.h

См. также раздел

LPWSPAccept

LPWSPConnect

LPWSPGetSockopt