CM_Free_Log_Conf_Handle function (cfgmgr32.h)

The CM_Free_Log_Conf_Handle function invalidates a logical configuration handle and frees its associated memory allocation.

Syntax

CMAPI CONFIGRET CM_Free_Log_Conf_Handle(
  [in] LOG_CONF lcLogConf
);

Parameters

[in] lcLogConf

Caller-supplied logical configuration handle. This handle must have been previously obtained by calling one of the following functions:

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

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 lcLogConf, it must subsequently call CM_Free_Log_Conf_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