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

Статья
08/24/2023

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

Синтаксис

typedef struct _SERVER_TRANSPORT_INFO_3 {
  DWORD  svti3_numberofvcs;
  LMSTR  svti3_transportname;
  LPBYTE svti3_transportaddress;
  DWORD  svti3_transportaddresslength;
  LMSTR  svti3_networkaddress;
  LMSTR  svti3_domain;
  ULONG  svti3_flags;
  DWORD  svti3_passwordlength;
  BYTE   svti3_password[256];
} SERVER_TRANSPORT_INFO_3, *PSERVER_TRANSPORT_INFO_3, *LPSERVER_TRANSPORT_INFO_3;

Члены

svti3_numberofvcs

Тип: DWORD

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

svti3_transportname

Тип: LMSTR

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

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

Если определены _WIN32_WINNT или FORCE_UNICODE , это строка Юникода.

svti3_transportaddress

Тип: LPBYTE

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

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

svti3_transportaddresslength

Тип: DWORD

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

svti3_networkaddress

Тип: LMSTR

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

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

Если определены _WIN32_WINNT или FORCE_UNICODE , это строка Юникода.

svti3_domain

Тип: LMSTR

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

Если определены _WIN32_WINNT или FORCE_UNICODE , это строка Юникода.

svti3_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).

svti3_passwordlength

Тип: DWORD

Количество допустимых байтов в элементе svti3_password .

svti3_password[256]

Тип: BYTE[256]

Учетные данные, используемые для нового адреса транспорта. Если элемент svti3_passwordlength равен нулю, используются учетные данные для сервера.

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

Элементы svti3_passwordlength и svti3_password необходимы для выполнения взаимной проверки подлинности клиентом и сервером.

В 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)