función CM_Free_Log_Conf (cfgmgr32.h)

  • Artículo

La función CM_Free_Log_Conf quita una configuración lógica y todos los descriptores de recursos asociados de la máquina local.

Sintaxis

CMAPI CONFIGRET CM_Free_Log_Conf(
  [in] LOG_CONF lcLogConfToBeFreed,
  [in] ULONG    ulFlags
);

Parámetros

[in] lcLogConfToBeFreed

Identificador proporcionado por el autor de la llamada a una configuración lógica. Este identificador debe haberse obtenido previamente llamando a una de las siguientes funciones:

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

[in] ulFlags

No se usa, debe ser cero.

Valor devuelto

Si la operación se realiza correctamente, la función devuelve CR_SUCCESS. De lo contrario, devuelve uno de los códigos de error CR_ prefijo definidos en Cfgmgr32.h.

Nota A partir de Windows 8, CM_Free_Log_Conf devuelve CR_CALL_NOT_IMPLEMENTED cuando se usa en un escenario wow64. Para solicitar información sobre los recursos de hardware en un equipo local, es necesario implementar una versión nativa de la arquitectura de la aplicación mediante las API de recursos de hardware. Por ejemplo: una aplicación AMD64 para sistemas AMD64.
 

Comentarios

Llamar a CM_Free_Log_Conf puede hacer que los identificadores devueltos por CM_Get_First_Log_Conf y CM_Get_Next_Log_Conf no sean válidos. Por lo tanto, si desea obtener configuraciones lógicas después de llamar a CM_Free_Log_Conf, el código debe llamar a CM_Get_First_Log_Conf de nuevo y empezar en la primera configuración.

Tenga en cuenta que llamar a CM_Free_Log_Conf libera la configuración, pero no el identificador de la configuración. Para liberar el identificador, llame a CM_Free_Log_Conf_Handle.

Los autores de llamadas de esta función deben tener SeLoadDriverPrivilege. (Los privilegios se describen en la documentación de Microsoft Windows SDK).

Requisitos

Requisito Value
Cliente mínimo compatible Disponible en Microsoft Windows 2000 y versiones posteriores de Windows.
Plataforma de destino Escritorio
Encabezado cfgmgr32.h (incluya Cfgmgr32.h)
Library Cfgmgr32.lib
Archivo DLL Cfgmgr32.dll

Consulte también

CM_Free_Log_Conf_Ex