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
 この表に示されている最初の 3 つの値のサポートを要求します。 呼び出し元のアプリケーションで UNICODE が定義されている場合は、前に示した 4 つの機能を要求します。

[out] OptionsSupported

ビット フラグのセットを受け取る値へのポインター。 フラグは 、OptionsWanted パラメーターで指定された機能が 、UncServerName パラメーターで指定されたコンピューターに実装されていることを示します。 (他のすべてのビットは 0 に設定されます)。

このパラメーターの値は、 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

ネットワーク管理機能

ネットワーク管理の概要

リモート ユーティリティ関数