Note

Access to this page requires authorization. You can try signing in or .

Access to this page requires authorization. You can try .

CM_Free_Res_Des_Handle function (cfgmgr32.h)

The CM_Free_Res_Des_Handle function invalidates a resource description handle and frees its associated memory allocation.

Syntax

CMAPI CONFIGRET CM_Free_Res_Des_Handle(
 [in] RES_DES rdResDes
);

Parameters

[in] rdResDes

Caller-supplied resource descriptor handle to be freed. This handle must have been previously obtained by calling one of the following functions:

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

Return value

If the operation succeeds, the function returns CR_SUCCESS. Otherwise, it returns one of the CR_-prefixed error codes defined in Cfgmgr32.h.

Remarks

Each time your code calls one of the functions listed under the description of rdResDes, it must subsequently call CM_Free_Res_Des_Handle.

Requirements

Requirement Value
Minimum supported client Available in Microsoft Windows 2000 and later versions of Windows.
Target Platform Desktop
Header cfgmgr32.h (include Cfgmgr32.h)
Library Cfgmgr32.lib
DLL Cfgmgr32.dll

Feedback

Was this page helpful?

Additional resources