CM_Free_Res_Des_Handle函式 (cfgmgr32.h)

CM_Free_Res_Des_Handle函式會使資源描述句柄失效，並釋放其相關聯的記憶體配置。

語法

CMAPI CONFIGRET CM_Free_Res_Des_Handle(
  [in] RES_DES rdResDes
);

參數

[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

傳回值

如果作業成功，函式會傳回CR_SUCCESS。 否則，它會傳回 Cfgmgr32.h 中定義的其中一個CR_前置錯誤碼。

備註

每次您的程式代碼呼叫 rdResDes 描述下所列的其中一個函式時，都必須接著呼叫 CM_Free_Res_Des_Handle。

規格需求