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

接收一組位旗標的值指標。 旗標表示 OptionsWanted 參數所指定的功能是在 UncServerName 參數所指定的電腦上實作。 (所有其他位都設定為零。)

只有當 NetRemoteComputerSupports 函式傳回NERR_Success時，此參數的值才有效。

傳回值

如果函式成功，傳回值會NERR_Success。

如果函式失敗，傳回值可以是下列其中一個錯誤碼。

傳回碼	Description
ERROR_INVALID_PARAMETER	OptionsWanted 參數或 OptionsSupported 參數為 NULL;這兩個參數都是必要參數。
ERROR_NOT_ENOUGH_MEMORY	記憶體不足。

備註

成功執行 NetRemoteComputerSupports 函式不需要特殊群組成員資格。

規格需求

需求	值
最低支援的用戶端	Windows 2000 Professional [僅限傳統型應用程式]
最低支援的伺服器	Windows 2000 Server [僅限桌面應用程式]
目標平台	Windows
標頭	lmremutl.h (包含 Lm.h)
程式庫	Netapi32.lib
Dll	Netapi32.dll

另請參閱

NetServerGetInfo

網路管理功能

網路管理概觀

遠端公用程式函式