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

Статья
11/20/2024

Структура 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 этой структуры и строкового члена LPSTR типа данных.

Функция WSCEnumNameSpaceProvidersEx3 2 — это только функция Юникода и возвращает WSANAMESPACE_INFOEXW структуры.

Заметка

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

Требования

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

См. также

NAPI_PROVIDER_INSTALLATION_BLOB

WSAEnumNameSpaceProvidersEx

WSANAMESPACE_INFO

WSCEnumNameSpaceProvidersEx32

WSCInstallNameSpaceEx

WSCInstallNameSpaceEx32

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