структура SERVER_TRANSPORT_INFO_3 (lmserver.h)
Структура 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 .
svti3_passwordlength
Тип: DWORD
Количество допустимых байтов в элементе svti3_password .
svti3_password[256]
Тип: BYTE[256]
Учетные данные, используемые для нового адреса транспорта. Если элемент svti3_passwordlength равен нулю, используются учетные данные для сервера.
Комментарии
Структура SERVER_TRANSPORT_INFO_3 используется функцией NetServerTransportAddEx для привязки указанного сервера к транспортному протоколу.
Ниже приведен пример использования значения 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) |