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

Статья
11/20/2024

Структура 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_INFOWSANAMESPACE_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 Профессиональный [только классические приложения]
минимальный поддерживаемый сервер	Windows 2000 Server [только классические приложения]
заголовка	winsock2.h