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

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

  • Статья

Структура 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

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

NAPI_PROVIDER_INSTALLATION_BLOB

WSAEnumNameSpaceProvidersEx

WSANAMESPACE_INFO

WSCEnumNameSpaceProvidersEx32

WSCInstallNameSpaceEx

WSCInstallNameSpaceEx32