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

Статья
08/27/2023

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

Синтаксис

typedef struct _WSANAMESPACE_INFOEXW {
  GUID   NSProviderId;
  DWORD  dwNameSpace;
  BOOL   fActive;
  DWORD  dwVersion;
  LPWSTR lpszIdentifier;
  BLOB   ProviderSpecific;
} WSANAMESPACE_INFOEXW, *PWSANAMESPACE_INFOEXW, *LPWSANAMESPACE_INFOEXW;

Члены

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

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

ProviderSpecific

Тип: BLOB

Большой двоичный объект данных конкретного поставщика, связанный с записью пространства имен.

Структура WSANAMESPACE_INFOEX — это расширенная версия структуры WSANAMESPACE_INFO , которая используется функциями WSAEnumNameSpaceProvidersEx и WSCEnumNameSpaceProvidersEx32 для возврата сведений о доступных поставщиках пространства имен. Структура WSANAMESPACE_INFOEX содержит большой двоичный объект данных конкретного поставщика, связанный с записью пространства имен, передаваемой в параметре lpProviderInfo в функции WSCInstallNameSpaceEx и WSCInstallNameSpaceEx32 .

В настоящее время единственным пространством имен, включенным в Windows, которое использует сведения в элементе ProviderSpecificструктуры WSANAMESPACE_INFOEX , являются поставщики пространств имен для NS_EMAIL пространства имен. Формат элемента ProviderSpecific для поставщика пространства имен NS_EMAIL является NAPI_PROVIDER_INSTALLATION_BLOB структурой.

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

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

Функция WSCEnumNameSpaceProvidersEx32 является функцией только в Юникоде и возвращает WSANAMESPACE_INFOEXW структур.

Примечание

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

Требования

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