структура SERVER_TRANSPORT_INFO_2 (lmserver.h)

Статья
08/24/2023

Структура SERVER_TRANSPORT_INFO_2 содержит сведения о указанном транспортном протоколе, включая имя и адрес транспорта. Этот уровень информации действителен только для функции NetServerTransportAddEx .

Синтаксис

typedef struct _SERVER_TRANSPORT_INFO_2 {
  DWORD  svti2_numberofvcs;
  LMSTR  svti2_transportname;
  LPBYTE svti2_transportaddress;
  DWORD  svti2_transportaddresslength;
  LMSTR  svti2_networkaddress;
  LMSTR  svti2_domain;
  ULONG  svti2_flags;
} SERVER_TRANSPORT_INFO_2, *PSERVER_TRANSPORT_INFO_2, *LPSERVER_TRANSPORT_INFO_2;

Члены

svti2_numberofvcs

Тип: DWORD

Число клиентов, подключенных к серверу, которые используют транспортный протокол, заданный элементом svti2_transportname .

svti2_transportname

Тип: LMSTR

Указатель на символьную строку, завершающуюся значением NULL, которая содержит имя транспортного устройства; Например

\Device\NetBT_Tcpip_{2C9725F4-151A-11D3-AEEC-C3B211BD350B}

Эта строка является Юникодом, если определены _WIN32_WINNT или FORCE_UNICODE .

svti2_transportaddress

Тип: LPBYTE

Указатель на переменную, содержащую адрес, который сервер использует на транспортном устройстве, указанном элементом svti2_transportname .

Обычно это netBIOS-имя, используемое сервером. В таких случаях имя должно быть длиной 16 символов, а последний символ должен быть пустым (0x20).

svti2_transportaddresslength

Тип: DWORD

Длина элемента svti2_transportaddress в байтах. Для netBIOS-имен значение этого элемента равно 16 (десятичное число).

svti2_networkaddress

Тип: LMSTR

Указатель на символьную строку с завершением NULL, содержащую адрес, который использует сетевой адаптер. Строка зависит от транспорта.

Это значение можно получить только с помощью вызова функции NetServerTransportEnum . Это значение нельзя задать с помощью вызова функции NetServerTransportAdd или NetServerTransportAddEx .)

Эта строка является Юникодом, если определены _WIN32_WINNT или FORCE_UNICODE .

svti2_domain

Тип: LMSTR

Указатель на символьную строку, завершающуюся значением NULL, которая содержит имя домена, в котором сервер должен объявить о своем присутствии. (При вызове NetServerTransportEnum этот член является именем домена, в котором сервер объявляет о своем присутствии.)

Эта строка является Юникодом, если определены _WIN32_WINNT или FORCE_UNICODE .

svti2_flags

Тип: ULONG

Этот член может быть сочетанием следующих битовых значений, определенных в файле заголовка Lmserver.h .

Значение	Значение
SVTI2_REMAP_PIPE_NAMES	Если это значение задано для конечной точки, клиентские запросы, поступающие через транспорт, чтобы открыть именованный канал, перенаправляются (перенаправляются) на следующее имя локального канала: $$\ServerName\PipeName Дополнительные сведения об использовании этого значения см. в разделе Примечания.
SVTI2_SCOPED_NAME	Если это значение задано для конечной точки и предпринята попытка создать второй транспорт с тем же сетевым адресом, но с другим именем транспорта и конфликтующими параметрами для флага SCOPED, создание этого транспорта завершится ошибкой. Таким образом, каждый зарегистрированный транспорт для заданного сетевого адреса должен иметь одну и ту же область действия. Дополнительные сведения об использовании этого значения см. в разделе Примечания. Это значение определяется в Windows Server 2008 и Windows Vista с пакетом обновления 1 (SP1).

Значение

SVTI2_REMAP_PIPE_NAMES

Если это значение задано для конечной точки, клиентские запросы, поступающие через транспорт, чтобы открыть именованный канал, перенаправляются (перенаправляются) на следующее имя локального канала:

$$\ServerName\PipeName

Дополнительные сведения об использовании этого значения см. в разделе Примечания.

SVTI2_SCOPED_NAME

Если это значение задано для конечной точки и предпринята попытка создать второй транспорт с тем же сетевым адресом, но с другим именем транспорта и конфликтующими параметрами для флага SCOPED, создание этого транспорта завершится ошибкой. Таким образом, каждый зарегистрированный транспорт для заданного сетевого адреса должен иметь одну и ту же область действия.

Дополнительные сведения об использовании этого значения см. в разделе Примечания.

Это значение определяется в Windows Server 2008 и Windows Vista с пакетом обновления 1 (SP1).

Ниже приведен пример использования значения SVTI2_REMAP_PIPE_NAMES. Вызовите функцию NetServerTransportAddEx , чтобы добавить транспорт на сервер, указав адрес MyServer в элементе svti2_transportaddress и SVTI2_REMAP_PIPE_NAMES в элементе svti2_flags . Когда клиент пытается открыть "Канал" в "\MyServer", клиент фактически открывает $$MyServer\Pipe.

В Windows Server 2008 и Windows Vista с пакетом обновления 1 (SP1) каждое имя, зарегистрированное на удаленном файловом сервере Windows (SRV), обозначается либо как имя с заданной областью, либо как имя без области действия. После этого каждый общий ресурс, добавляемый в систему, будет либо присоединен ко всем именам без области действия, либо к одному имени с заданной областью. Приложения, которые хотят использовать функции области, отвечают как за регистрацию нового имени в качестве конечной точки с заданной областью, так и за создание общих папок с соответствующим область. Таким образом, устаревшие функции управления сетью и управления общими сетевыми ресурсами никак не затрагиваются, так как они продолжают регистрировать общие папки и имена как имена без области действия.

Конечная точка с заданной областью создается путем вызова функции NetServerTransportAddEx с параметром level , равным 2, а параметр bufptr указывает на SERVER_TRANSPORT_INFO_2 структуру с SVTI2_SCOPED_NAME битовое значение, заданное в элементе svti2_flags . Конечная точка с заданной областью также создается путем вызова функции NetServerTransportAddEx с параметром level , равным 3, а параметр bufptr указывает на SERVER_TRANSPORT_INFO_3 структуру с SVTI2_SCOPED_NAME битовое значение, заданное в элементе svti3_flags .

Если для транспорта задано битовое значение SVTI2_SCOPED_NAME , общие папки можно добавить с соответствующим именем сервера ( shi503_servername членом структуры SHARE_INFO_503 ) с помощью функции NetShareAdd . Если нет транспорта, зарегистрированного с SVTI2_SCOPED_NAME битовое значение и имя, указанное в элементе shi503_servername , добавление общей папки с заданной областью не будет выполнено.

Функция NetShareAdd используется для добавления общей папки с заданной областью на удаленный сервер, указанный в параметре servername . Удаленный сервер, указанный в shi503_servernameчлене SHARE_INFO_503 , переданного в параметре bufptr , должен быть привязан к транспортному протоколу с помощью функции NetServerTransportAddEx в качестве конечной точки с заданной областью. Флаг SVTI2_SCOPED_NAME должен быть указан в элементе shi503_servernameструктуры SERVER_TRANSPORT_INFO_2 или SERVER_TRANSPORT_INFO_3 для транспортного протокола. Функция NetShareDelEx используется для удаления общего ресурса с заданной областью. Функции NetShareGetInfo и NetShareSetInfo используются для получения и задания сведений об общем ресурсе с заданной областью.

Конечные точки с заданной областью обычно используются пространством имен кластера.

Требования


Минимальная версия клиента	Windows 2000 Professional [только классические приложения]
Минимальная версия сервера	Windows 2000 Server [только классические приложения]
Верхняя часть	lmserver.h (включая Lm.h)