CM_Free_Res_Des_Ex関数 (cfgmgr32.h)

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

CM_Free_Res_Des_Ex関数は、ローカル コンピューターまたはリモート コンピューターの論理構成からリソース記述子を削除します。

構文

CMAPI CONFIGRET CM_Free_Res_Des_Ex(
  [out]          PRES_DES prdResDes,
  [in]           RES_DES  rdResDes,
  [in]           ULONG    ulFlags,
  [in, optional] HMACHINE hMachine
);

パラメーター

[out] prdResDes

構成の以前のリソース記述子へのハンドルを受け取る呼び出し元が指定した場所。 このパラメーターは、NULL でもかまいません。 詳細については、次の 「解説 」セクションを参照してください。

[in] rdResDes

削除するリソース記述子に対する呼び出し元によって指定されたハンドル。 このハンドルは、以前に次のいずれかの関数を呼び出すことによって取得されている必要があります。

CM_Add_Res_Des

CM_Add_Res_Des_Ex

CM_Get_Next_Res_Des

CM_Get_Next_Res_Des_Ex

CM_Modify_Res_Des

CM_Modify_Res_Des_Ex

[in] ulFlags

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

[in, optional] hMachine

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

戻り値

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

注釈

各構成のリソース記述子は、配列に格納されます。 prdResDes のアドレスを指定した場合、CM_Free_Res_Desは、配列内の前のリソース記述子に対するハンドルを、削除されたリソース記述子に返します。 rdResDes で指定されたハンドルが配列内の最初にあるリソース記述子を表す場合、prdResDes は論理構成へのハンドルを受け取ります。

CM_Free_Res_Des_Exを呼び出すとリソース記述子は解放されますが、記述子のハンドルは解放されないことに注意してください。 ハンドルを解放するには、 CM_Free_Res_Des_Handle_Exを呼び出します。

この関数の呼び出し元には SeLoadDriverPrivilege が必要です。 (特権については、Microsoft Windows SDKドキュメントを参照してください。

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

要件

こちらもご覧ください

CM_Free_Res_Des