CONFIGMG_Get_Next_Log_Conf

CONFIGRET CONFIGMG_Get_Next_Log_Conf(PLOG_CONF plcLogConf, LOG_CONF lcLogConf, ULONG ulFlags)

Returns a handle to the next logical configuration following the given configuration.

• Returns CR_SUCCESS if the function is successful. Otherwise, the return value can be CR_INVALID_DEVNODE, CR_INVALID_FLAG, CR_INVALID_LOG_CONF, CR_INVALID_POINTER or CR_NO_MORE_LOG_CONF.

plcLogConf

Address receiving the handle of the next logical configuration.

lcLogConf

Logical configuration prior to the configuration whose handle is being retrieved. Note that the logical configurations are in priority order.

ulFlags

Must be zero.

When this function is called with a logical configuration that was obtained using the CONFIGMG_Get_First_Log_Conf function with either the ALLOC_LOG_CONF or BOOT_LOG_CONF flag it necessarily returns CR_NO_MORE_LOG_CONF. (There is only one active boot or currently allocated logical configuration.)

Note: Calling CONFIGMG_Add_Empty_Log_Conf or CONFIGMG_Free_Log_Conf from within a CONFIGMG_Get_First_Log_Conf/CONFIGMG_Get_Next_Log_Conf loop may have unwelcome side effects. Drivers should end the loop before adding or freeing a logical configuration and start it again when the operation is finished.

See also CONFIGMG_Add_Empty_Log_Conf, CONFIGMG_Free_Log_Conf, CONFIGMG_Get_First_Log_Conf