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によって返されるマシン ハンドルを提供します。
戻り値
関数が指定したコンピューターに接続できる場合、およびマシンが指定したバージョンをサポートしている場合、関数は 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 |