CM_Get_Version_Ex関数 (cfgmgr32.h)

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

CM_Get_Version_Ex関数は、ローカル コンピューターまたはリモート コンピューターのプラグ アンド プレイ (PnP) Configuration Manager DLL (Cfgmgr32.dll) のバージョン 4.0 を返します。

構文

CMAPI WORD CM_Get_Version_Ex(
  [in, optional] HMACHINE hMachine
);

パラメーター

[in, optional] hMachine

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

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

 

戻り値

関数が成功すると、上位バイトのメジャー リビジョン番号と、下位バイトのマイナー リビジョン番号が返されます。 バージョン 4.0 は、0x0400として返されます。 既定では、バージョン 4.0 は Microsoft Windows 2000 以降のバージョンの Windows でサポートされています。 内部エラーが発生した場合、関数は0x0000を返します。 GetLastError を呼び出して、エラーのエラー コードを取得します。

解説

この関数は、バージョン 4.0 以降のバージョンの構成マネージャーとの互換性を確保し、構成マネージャーのバージョン 4.0 を必要とするすべてのアプリケーションとの互換性を確保するために、構成マネージャーのバージョン 4.0 を返します。

特定のバージョンの構成マネージャーがコンピューターで使用できるかどうかを確認するには、 CM_Is_Version_Available または CM_Is_Version_Available_Exを使用します。

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

要件

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

関連項目

CM_Get_Version

CM_Is_Version_Available

CM_Is_Version_Available_Ex