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

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

  • Статья

Функция 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
 Недостаточно памяти.

Комментарии

Для успешного выполнения функции NetRemoteComputerSupports специальное членство в группе не требуется.

Требования

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

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

NetServerGetInfo

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

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

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