NetRemoteComputerSupports 函数 (lmremutl.h)

  • 项目

NetRemoteComputerSupports 函数查询重定向器以检索远程系统支持的可选功能。 功能包括 Unicode、远程过程调用 (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
 请求 Unicode 标准支持。
SUPPORTS_LOCAL
 请求支持此表中列出的前三个值。 如果 UNICODE 由调用应用程序定义，则请求前面列出的四个功能。

[out] OptionsSupported

指向接收一组位标志的值的指针。 标志指示在 UncServerName 参数指定的计算机上实现 OptionsWanted 参数指定的功能。 (所有其他位都设置为零。)

仅当 NetRemoteComputerSupports 函数返回NERR_Success时，此参数的值才有效。

返回值

如果函数成功，则返回值NERR_Success。

如果函数失败，则返回值可能是以下错误代码之一。

返回代码 说明
ERROR_INVALID_PARAMETER
 OptionsWanted 参数或 OptionsSupported 参数为 NULL;这两个参数是必需的。
ERROR_NOT_ENOUGH_MEMORY
 可用内存不足。

注解

无需特殊的组成员身份即可成功执行 NetRemoteComputerSupports 函数。

要求

要求 值
最低受支持的客户端 Windows 2000 Professional [仅限桌面应用]
最低受支持的服务器 Windows 2000 Server [仅限桌面应用]
目标平台 Windows
标头 lmremutl.h (包括 Lm.h)
Library Netapi32.lib
DLL Netapi32.dll

另请参阅

NetServerGetInfo

网络管理功能

网络管理概述

远程实用工具函数