Compartir a través de

función CM_Get_First_Log_Conf (cfgmgr32.h)

  • Artículo

La función CM_Get_First_Log_Conf obtiene la primera configuración lógica, de un tipo de configuración especificado, asociado a una instancia de dispositivo especificada en el equipo local.

Sintaxis

CMAPI CONFIGRET CM_Get_First_Log_Conf(
  [out, optional] PLOG_CONF plcLogConf,
  [in]            DEVINST   dnDevInst,
  [in]            ULONG     ulFlags
);

Parámetros

[out, optional] plcLogConf

Dirección de una ubicación para recibir el identificador de una configuración lógica o NULL. Consulte la siguiente sección Comentarios .

[in] dnDevInst

Identificador de instancia de dispositivo proporcionado por el autor de la llamada que está enlazado al equipo local.

[in] ulFlags

Valor de marca proporcionado por el autor de la llamada que indica el tipo de configuración lógica que se solicita. Se debe especificar una de las marcas de la tabla siguiente.

Marcas de tipo de configuración Definiciones
BASIC_LOG_CONF El autor de la llamada solicita información de configuración básica .
FILTERED_LOG_CONF El autor de la llamada solicita información de configuración filtrada .
ALLOC_LOG_CONF El autor de la llamada solicita información de configuración asignada .
BOOT_LOG_CONF El autor de la llamada solicita información de configuración de arranque .
FORCED_LOG_CONF El autor de la llamada solicita información de configuración forzada .
OVERRIDE_LOG_CONF El autor de la llamada solicita información de configuración de invalidación .

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_Get_First_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 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 o CM_Free_Log_Conf puede invalidar el identificador obtenido de una llamada anterior a CM_Get_First_Log_Conf. Por lo tanto, si desea obtener configuraciones lógicas después de llamar a CM_Add_Empty_Log_Conf o CM_Free_Log_Conf, el código debe llamar a CM_Get_First_Log_Conf de nuevo y empezar en la primera configuración.

El identificador recibido en plcLogConf debe liberarse explícitamente llamando a CM_Free_Log_Conf_Handle.

Si se llama a CM_Get_First_Log_Conf con plcLogConf establecido en NULL, no se devuelve ningún identificador. Esto le permite usar el estado de devolución para determinar si existe una configuración sin necesidad de liberar posteriormente el identificador.

Para obtener información sobre el uso de identificadores de instancia de dispositivo enlazados al equipo local, consulte CM_Get_Child.

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_Add_Empty_Log_Conf

CM_Free_Log_Conf

CM_Free_Log_Conf_Handle

CM_Get_Child

CM_Get_First_Log_Conf_Ex