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

Статья
08/27/2023

Структура WSANAMESPACE_INFO содержит все сведения о регистрации для поставщика пространства имен.

Синтаксис

typedef struct _WSANAMESPACE_INFOW {
  GUID   NSProviderId;
  DWORD  dwNameSpace;
  BOOL   fActive;
  DWORD  dwVersion;
  LPWSTR lpszIdentifier;
} WSANAMESPACE_INFOW, *PWSANAMESPACE_INFOW, *LPWSANAMESPACE_INFOW;

Члены

NSProviderId

Тип: GUID

Уникальный GUID для этого поставщика пространства имен.

dwNameSpace

Тип: DWORD

Пространство имен, поддерживаемое этим поставщиком.

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

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

fActive

Тип: BOOL

Значение TRUE указывает, что этот поставщик пространства имен активен. Значение FALSE означает, что поставщик пространства имен неактивен и недоступен для запросов, даже если запрос специально ссылается на этот поставщик пространства имен.

dwVersion

Тип: DWORD

Номер версии поставщика пространства имен.

lpszIdentifier

Тип: LPTSTR

Отображаемая строка, идентифицирующая поставщика пространства имен.

Структура WSANAMESPACE_INFO используется функциями WSAEnumNameSpaceProviders и WSCEnumNameSpaceProviders32 для возврата сведений о доступных поставщиках пространств имен. Структура WSANAMESPACE_INFO содержит сведения о конкретном поставщике записи пространства имен, передаваемой функциям WSCInstallNameSpace и WSCInstallNameSpace32 при установке поставщика пространства имен.

При определении ЮНИКОДа или _UNICODE WSANAMESPACE_INFO определяется для WSANAMESPACE_INFOW, версия Юникода этой структуры данных и строковый член lpszIdentifier определяются для типа данных LPWSTR .

Если юникод или _UNICODE не определены, WSANAMESPACE_INFO определяется для WSANAMESPACE_INFOA, версия ANSI этой структуры данных и строковый член lpszIdentifier определяются для типа данных LPSTR .

В Windows Vista и более поздних версиях WSANAMESPACE_INFOEX, расширенная версия структуры WSANAMESPACE_INFO , возвращается вызовами функций WSAEnumNameSpaceProvidersEx и WSCEnumNameSpaceProvidersEx32 .

Примечание

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

Требования

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