CM_Get_Log_Conf_Priority_Ex関数 (cfgmgr32.h)

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

CM_Get_Log_Conf_Priority_Ex関数は、ローカル コンピューターまたはリモート コンピューター上の指定された論理構成の構成優先度を取得します。

構文

CMAPI CONFIGRET CM_Get_Log_Conf_Priority_Ex(
  [in]           LOG_CONF  lcLogConf,
  [out]          PPRIORITY pPriority,
  [in]           ULONG     ulFlags,
  [in, optional] HMACHINE  hMachine
);

パラメーター

[in] lcLogConf

論理構成に対する呼び出し元指定ハンドル。 このハンドルは、次のいずれかの関数を呼び出すことによって以前に取得されている必要があります。

CM_Add_Empty_Log_Conf

CM_Add_Empty_Log_Conf_Ex

CM_Get_First_Log_Conf

CM_Get_First_Log_Conf_Ex

CM_Get_Next_Log_Conf

CM_Get_Next_Log_Conf_Ex

[out] pPriority

構成優先度の値を受け取る場所の呼び出し元から指定されたアドレス。 優先度の値の一覧については、「CM_Add_Empty_Log_Conf_Ex優先度」の説明を参照してください。

[in] ulFlags

使用しません。0 にする必要があります。

[in, optional] hMachine

呼び出し元から指定されたマシン ハンドル。 CM_Connect_Machineの前の呼び出しから取得されます。

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

戻り値

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

メモWindows 8以降、wow64 シナリオで使用すると、CM_Get_Log_Conf_Priority_ExはCR_CALL_NOT_IMPLEMENTEDを返します。 ローカル コンピューター上のハードウェア リソースに関する情報を要求するには、ハードウェア リソース API を使用してアーキテクチャネイティブ バージョンのアプリケーションを実装する必要があります。 例: AMD64 システム用の AMD64 アプリケーション。
 

注釈

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

要件

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

こちらもご覧ください

CM_Get_Log_Conf_Priority