CM_Is_Version_Available_Ex関数 (cfgmgr32.h)

[Windows 8とWindows Server 2012以降、この関数は非推奨となり、使用しないでください。]

CM_Is_Version_Available_Ex関数は、指定したバージョンの プラグ アンド プレイ (PnP) Configuration Manager DLL (Cfgmgr32.dll) がローカル コンピューターまたはリモート コンピューターでサポートされているかどうかを示します。

構文

CMAPI BOOL CM_Is_Version_Available_Ex(
  [in]           WORD     wVersion,
  [in, optional] HMACHINE hMachine
);

パラメーター

[in] wVersion

構成マネージャーのバージョンを識別します。 サポートされているバージョンの構成マネージャーは、オペレーティング システムのバージョンに直接対応しています。 メジャー バージョンは高位バイトで指定され、マイナー バージョンは下位バイトで指定されます。 たとえば、0x0400はバージョン 4.0 を指定します。これは、Microsoft Windows NT 4.0 以降のバージョンの Windows で既定でサポートされています。 バージョン 0x0501は、Windows XP 以降のバージョンの Windows でサポートされているバージョン 5.1 を指定します。

[in, optional] hMachine

CM_Connect_Machineによって返されるマシン ハンドルを提供します。

メモこの機能は削除されたため、この関数を使用してリモート マシンにアクセスすることは、Windows 8とWindows Server 2012以降はサポートされていません。

 

戻り値

関数が指定したコンピューターに接続できる場合、およびマシンが指定したバージョンをサポートしている場合、関数は TRUE を 返します。 それ以外の場合、関数は FALSE を返します。

注釈

この関数を使用して、指定したバージョンの構成マネージャーがローカル コンピューターとリモート コンピューターのどちらでサポートされているかを判断します。 指定したバージョンがサポートされている場合は、以前のすべてのバージョン (このバージョンを含む) がコンピューターでサポートされます。 CM_Is_Version_Availableを使用して、ローカル コンピューターが特定のバージョンの構成マネージャーをサポートしているかどうかを判断することもできます。

リモート マシンにアクセスする機能は、Windows 8およびWindows Server 2012以降のオペレーティング システムで削除されているため、これらのバージョンの Windows で実行している場合はリモート マシンにアクセスできません。

要件

要件	値
サポートされている最小のクライアント	Windows XP 以降のバージョンの Windows で使用できます。
対象プラットフォーム	デスクトップ
Header	cfgmgr32.h (Cfgmgr32.h を含む)
Library	Cfgmgr32.lib
[DLL]	Cfgmgr32.dll

こちらもご覧ください

CM_Connect_Machine

CM_Get_Version

CM_Get_Version_Ex

CM_Is_Version_Available