función CM_Add_Empty_Log_Conf_Ex (cfgmgr32.h)

Artículo
02/23/2024

[A partir de Windows 8 y Windows Server 2012, esta función ha quedado en desuso. Use CM_Add_Empty_Log_Conf en su lugar.

La función CM_Add_Empty_Log_Conf_Ex crea una configuración lógica vacía, para un tipo de configuración especificado y una instancia de dispositivo especificada, en la máquina local o remota.

Sintaxis

CMAPI CONFIGRET CM_Add_Empty_Log_Conf_Ex(
  [out]          PLOG_CONF plcLogConf,
  [in]           DEVINST   dnDevInst,
  [in]           PRIORITY  Priority,
  [in]           ULONG     ulFlags,
  [in, optional] HMACHINE  hMachine
);

Parámetros

[out] plcLogConf

Puntero a una ubicación para recibir el identificador a una configuración lógica vacía.

[in] dnDevInst

Identificador de instancia de dispositivo proporcionado por el autor de la llamada que está enlazado al controlador de máquina proporcionado por hMachine.

[in] Priority

Valor de prioridad de configuración proporcionado por el autor de la llamada. Para obtener una lista de valores, consulte la descripción de prioridad de CM_Add_Empty_Log_Conf.

[in] ulFlags

Marcas proporcionadas por el autor de la llamada que especifican el tipo de la configuración lógica. Para obtener una lista de marcas, consulte la descripción ulFlags description para CM_Add_Empty_Log_Conf.

[in, optional] hMachine

Identificador de máquina proporcionado por el autor de la llamada al que está enlazado el identificador de instancia de dispositivo proporcionado por el autor de la llamada.

Nota No se admite el uso de esta función para acceder a máquinas remotas a partir de Windows 8 y Windows Server 2012, ya que esta funcionalidad se ha quitado.

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 con prefijo CR_ definidos en Cfgmgr32.h.

Nota A partir de Windows 8, CM_Add_Empty_Log_Conf_Ex 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 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_Add_Empty_Log_Conf_Ex puede hacer que los identificadores devueltos por CM_Get_First_Log_Conf_Ex y CM_Get_Next_Log_Conf_Ex no sean válidos. Por lo tanto, si desea obtener configuraciones lógicas después de llamar a CM_Add_Empty_Log_Conf_Ex, el código debe llamar a CM_Get_First_Log_Conf_Ex de nuevo y empezar en la primera configuración.

Para quitar una configuración lógica creada por CM_Add_Empty_Log_Conf_Ex, llame a CM_Free_Log_Conf_Ex.

El identificador recibido en plcLogConf debe liberarse explícitamente llamando 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).

Para obtener información sobre el uso de identificadores de instancia de dispositivo enlazados a un equipo local o remoto, consulte CM_Get_Child_Ex.

La funcionalidad para acceder a las máquinas remotas se ha quitado en Windows 8 y sistemas operativos Windows Server 2012 y versiones posteriores, por lo que no se puede acceder a las máquinas remotas cuando se ejecutan en estas versiones de Windows.

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