Функция NetRemoteComputerSupports (lmremutl.h)

Статья
08/24/2023

Функция NetRemoteComputerSupports запрашивает у перенаправителя дополнительные функции, поддерживаемые удаленной системой. Функции включают Юникод, удаленный вызов процедур (RPC) и поддержку протокола удаленного администрирования. Функция устанавливает сетевое подключение, если оно не существует.

Синтаксис

NET_API_STATUS NET_API_FUNCTION NetRemoteComputerSupports(
  [in]  LPCWSTR UncServerName,
  [in]  DWORD   OptionsWanted,
  [out] LPDWORD OptionsSupported
);

Параметры

[in] UncServerName

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

[in] OptionsWanted

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

Значение	Значение
SUPPORTS_REMOTE_ADMIN_PROTOCOL	Запрашивает поддержку протокола удаленного администрирования.
SUPPORTS_RPC	Запрашивает поддержку RPC.
SUPPORTS_SAM_PROTOCOL	Запрашивает поддержку диспетчера учетных записей безопасности (SAM).
SUPPORTS_UNICODE	Запрашивает стандартную поддержку Юникода.
SUPPORTS_LOCAL	Запрашивает поддержку первых трех значений, перечисленных в этой таблице. Если ЮНИКОД определен вызывающим приложением, запрашивает четыре функции, перечисленные ранее.

[out] OptionsSupported

Указатель на значение, которое получает набор битовых флагов. Флаги указывают, какие функции, заданные параметром OptionsWanted, реализуются на компьютере, указанном параметром UncServerName . (Все остальные биты равны нулю.)

Значение этого параметра допустимо, только если функция NetRemoteComputerSupports возвращает NERR_Success.

Возвращаемое значение

Если функция выполняется успешно, возвращаемое значение будет NERR_Success.

Если функция завершается сбоем, возвращаемое значение может быть одним из следующих кодов ошибок.

Код возврата	Описание
ERROR_INVALID_PARAMETER	Параметр OptionsWanted или OptionsSupported имеет значение NULL; оба параметра являются обязательными.
ERROR_NOT_ENOUGH_MEMORY	Недостаточно памяти.

Требования

Требование	Значение
Минимальная версия клиента	Windows 2000 Professional [только классические приложения]
Минимальная версия сервера	Windows 2000 Server [только классические приложения]
Целевая платформа	Windows
Header	lmremutl.h (включая Lm.h)
Библиотека	Netapi32.lib
DLL	Netapi32.dll

См. также раздел

NetServerGetInfo

Функции управления сетью

Общие сведения об управлении сетью

Функции удаленной служебной программы