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

структура WSAQUERYSET2A (winsock2.h)

  • Статья

Структура WSAQUERYSET2 предоставляет соответствующие сведения о данной службе, включая идентификатор класса службы, имя службы, применимые идентификаторы пространства имен и сведения о протоколе, а также набор транспортных адресов, по которым служба прослушивает.

Синтаксис

typedef struct _WSAQuerySet2A {
  DWORD         dwSize;
  LPSTR         lpszServiceInstanceName;
  LPWSAVERSION  lpVersion;
  LPSTR         lpszComment;
  DWORD         dwNameSpace;
  LPGUID        lpNSProviderId;
  LPSTR         lpszContext;
  DWORD         dwNumberOfProtocols;
  LPAFPROTOCOLS lpafpProtocols;
  LPSTR         lpszQueryString;
  DWORD         dwNumberOfCsAddrs;
  LPCSADDR_INFO lpcsaBuffer;
  DWORD         dwOutputFlags;
  LPBLOB        lpBlob;
} WSAQUERYSET2A, *PWSAQUERYSET2A, *LPWSAQUERYSET2A;

Члены

dwSize

Тип: DWORD

Размер структуры WSAQUERYSET2 в байтах. Этот элемент используется в качестве механизма управления версиями, так как размер WSAQUERYSET2 структуры может измениться в более поздних версиях Windows.

lpszServiceInstanceName

Тип: LPTSTR

Указатель на необязательную строку NULL-terminated, содержащую имя службы. Семантика для использования подстановочных знаков в строке не определена, но может поддерживаться определенными поставщиками пространств имен.

lpVersion

Тип: LPWSAVERSION

Указатель на необязательный номер версии поставщика пространства имен. Этот член предоставляет семантику сравнения версий (т. е. запрошенная версия должна соответствовать точно, или версия не должна быть меньше указанного значения).

lpszComment

Тип: LPTSTR

Этот элемент игнорируется для запросов.

dwNameSpace

Тип: DWORD

Идентификатор пространства имен, определяющий, какие поставщики пространств имен запрашиваются. Передача определенного идентификатора пространства имен приведет только к поставщикам пространств имен, которые поддерживают запрос указанного пространства имен. Указание NS_ALL приведет к запросу всех установленных и активных поставщиков пространств имен.

Параметры элемента dwNameSpace перечислены в файле Winsock2.h. Несколько новых поставщиков пространств имен включены в Windows Vista и более поздних версий. Другие поставщики пространств имен можно установить, поэтому следующие возможные значения являются доступными только теми, которые обычно доступны. Возможны многие другие значения.

Ценность Значение
NS_ALL
 Все установленные и активные пространства имен.
NS_BTH
 Пространство имен Bluetooth. Этот идентификатор пространства имен поддерживается в Windows Vista и более поздних версиях.
NS_DNS
 Пространство имен системы доменных имен (DNS).
NS_EMAIL
 Пространство имен электронной почты. Этот идентификатор пространства имен поддерживается в Windows Vista и более поздних версиях.
NS_NLA
 Пространство имен "Осведомленность о расположении сети" (NLA). Этот идентификатор пространства имен поддерживается в Windows XP и более поздних версиях.
NS_PNRPNAME
 Пространство имен однорангового узла для определенного имени однорангового узла. Этот идентификатор пространства имен поддерживается в Windows Vista и более поздних версиях.
NS_PNRPCLOUD
 Пространство имен однорангового узла для коллекции одноранговых имен. Этот идентификатор пространства имен поддерживается в Windows Vista и более поздних версиях.

lpNSProviderId

Тип: LPGUID

Указатель на необязательный GUID конкретного поставщика пространства имен для запроса в том случае, если несколько поставщиков пространств имен зарегистрированы в одном пространстве имен, например NS_DNS. Передача GUID для определенного поставщика пространства имен приведет к запросу только указанного поставщика пространства имен. функции WSAEnumNameSpaceProviders и функции WSAEnumNameSpaceProvidersEx можно вызвать для получения GUID поставщика пространства имен.

lpszContext

Тип: LPTSTR

Указатель на необязательную начальную точку запроса в иерархическом пространстве имен.

dwNumberOfProtocols

Тип: DWORD

Размер массива ограничений протокола в байтах. Этот элемент может быть нулевым.

lpafpProtocols

Тип: LPAFPROTOCOLS

Указатель на необязательный массив структур AFPROTOCOLS. Будут возвращены только службы, использующие эти протоколы.

lpszQueryString

Тип: LPTSTR

Указатель на необязательную строку запроса NULL-terminated. Некоторые пространства имен, такие как Whois++, поддерживают расширенные запросы, такие как SQL, содержащиеся в простой текстовой строке. Этот параметр используется для указания этой строки.

dwNumberOfCsAddrs

Тип: DWORD

Этот элемент игнорируется для запросов.

lpcsaBuffer

Тип: LPCSADDR_INFO

Этот элемент игнорируется для запросов.

dwOutputFlags

Тип: DWORD

Этот элемент игнорируется для запросов.

lpBlob

Тип: LPBLOB

Необязательный указатель на данные, используемые для запроса или задания сведений о пространстве имен для конкретного поставщика. Формат этих сведений зависит от поставщика пространства имен.

Замечания

Структура WSAQUERYSET2 используется в составе архитектуры поставщика услуг пространства имен версии 2 (NSPv2), доступной в Windows Vista и более поздних версиях.

В Windows Vista и Windows Server 2008 структура WSAQUERYSET2 может использоваться только для операций с поставщиками пространств имен NS_EMAIL.

Заметка

Заголовок winsock2.h определяет WSAQUERYSET2 как псевдоним, который автоматически выбирает версию ANSI или Юникод этой функции на основе определения константы препроцессора ЮНИКОДа. Сочетание использования псевдонима, нейтрального для кодирования, с кодом, не зависящим от кодирования, может привести к несоответствиям, которые приводят к ошибкам компиляции или среды выполнения. Дополнительные сведения см. в соглашениях о прототипах функций.

Требования

Требование Ценность
минимальные поддерживаемые клиентские Windows Vista [только классические приложения]
минимальный поддерживаемый сервер Windows Server 2008 [только классические приложения]
заголовка winsock2.h

См. также

WSAEnumNameSpaceProviders

WSAEnumNameSpaceProvidersEx

WSASetService