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
要移除之資源描述元的呼叫端提供句柄。 這個句柄先前必須藉由呼叫下列其中一個函式來取得：
[in] ulFlags
未使用，必須是零。
[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 上執行時存取遠端電腦。
要求
| 要求 | 價值 |
|---|---|
| 最低支援的用戶端 | Microsoft Windows 2000 和更新版本的 Windows 中提供。 |
| 目標平臺 | 桌面 |
| 標頭 | cfgmgr32.h （包括 Cfgmgr32.h） |
| 連結庫 | Cfgmgr32.lib |
| DLL | Cfgmgr32.dll |