CM_Is_Dock_Station_Present_Ex関数 (cfgmgr32.h)

  • [アーティクル]

[Windows 8とWindows Server 2012以降、この関数は非推奨となりました。 代わりに CM_Is_Dock_Station_Present を使用してください。]

CM_Is_Dock_Station_Present_Ex関数は、ドッキング ステーションがローカル コンピューターとリモート コンピューターのどちらに存在するかを識別します。

構文

CMAPI CONFIGRET CM_Is_Dock_Station_Present_Ex(
  [out]          PBOOL    pbPresent,
  [in, optional] HMACHINE hMachine
);

パラメーター

[out] pbPresent

ドッキング ステーションがローカル コンピューターに存在するかどうかを示すブール値へのポインター。 ドッキング ステーションが存在する場合、関数は *pbPresent を TRUE に 設定します。 関数が指定したコンピューターに接続できない場合、またはドッキング ステーションが存在しない場合、関数は *pbPresentを FALSE に 設定します。

[in, optional] hMachine

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

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

戻り値

操作が成功した場合、関数は CR_SUCCESSを返します。 それ以外の場合、関数は Cfgmgr32.h で定義されているCR_プレフィックス付きのエラー コードのいずれかを返します。

注釈

この関数を使用して、ドッキング ステーションがローカル コンピューターとリモート コンピューターのどちらに存在するかを確認します。 ドッキング ステーションでは、次の関連関数を使用することもできます。

  • CM_Is_Dock_Station_Present は、ドッキング ステーションがローカル コンピューターに存在するかどうかを識別します。

  • CM_Request_Eject_PC は、ローカル・ドッキング・ステーションに挿入されたポータブル PC の取り出しを要求します。

  • CM_Request_Eject_PC_Ex は、ローカルまたはリモートのドッキング ステーションに挿入されたポータブル PC を取り出すように要求します。

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

要件

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

こちらもご覧ください

CM_Is_Dock_Station_Present

CM_Request_Eject_PC

CM_Request_Eject_PC_Ex