Функция WSAGetQOSByName (winsock2.h)

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

Синтаксис

BOOL WSAAPI WSAGetQOSByName(
  [in]      SOCKET   s,
  [in, out] LPWSABUF lpQOSName,
  [out]     LPQOS    lpQOS
);

Параметры

[in] s

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

[in, out] lpQOSName

Указатель на определенный шаблон качества службы.

[out] lpQOS

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

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

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

Комментарии

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

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

Требования

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

QOS

WSAAccept

WSAConnect

Функции Winsock

Справочник по Winsock

getsockopt