fonction CM_Get_First_Log_Conf (cfgmgr32.h)

Article
02/23/2024

La fonction CM_Get_First_Log_Conf obtient la première configuration logique, d’un type de configuration spécifié, associée à un appareil spécifié instance sur l’ordinateur local.

Syntaxe

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

Paramètres

[out, optional] plcLogConf

Adresse d’un emplacement pour recevoir le handle vers une configuration logique, ou NULL. Consultez la section Remarques suivante.

[in] dnDevInst

L’appareil fourni par l’appelant instance handle lié à l’ordinateur local.

[in] ulFlags

Valeur d’indicateur fournie par l’appelant indiquant le type de configuration logique demandée. L’un des indicateurs du tableau suivant doit être spécifié.

Indicateurs de type de configuration	Définitions
BASIC_LOG_CONF	L’appelant demande des informations de configuration de base .
FILTERED_LOG_CONF	L’appelant demande des informations de configuration filtrées .
ALLOC_LOG_CONF	L’appelant demande des informations de configuration allouées .
BOOT_LOG_CONF	L’appelant demande des informations de configuration de démarrage .
FORCED_LOG_CONF	L’appelant demande des informations de configuration forcée .
OVERRIDE_LOG_CONF	L’appelant demande des informations de configuration de remplacement .

Valeur retournée

Si l’opération réussit, la fonction retourne CR_SUCCESS. Sinon, il retourne l’un des codes d’erreur CR_ préfixés définis dans Cfgmgr32.h.

Note À compter de Windows 8, CM_Get_First_Log_Conf retourne CR_CALL_NOT_IMPLEMENTED lorsqu’il est utilisé dans un scénario Wow64. Pour demander des informations sur les ressources matérielles sur un ordinateur local, il est nécessaire d’implémenter une version native d’architecture de l’application à l’aide des API de ressources matérielles. Par exemple : une application AMD64 pour les systèmes AMD64.

Remarques

L’appel de CM_Add_Empty_Log_Conf ou de CM_Free_Log_Conf peut invalider le handle obtenu à partir d’un appel précédent à CM_Get_First_Log_Conf. Ainsi, si vous souhaitez obtenir des configurations logiques après avoir appelé CM_Add_Empty_Log_Conf ou CM_Free_Log_Conf, votre code doit appeler à nouveau CM_Get_First_Log_Conf et démarrer à la première configuration.

Le handle reçu dans plcLogConf doit être explicitement libéré en appelant CM_Free_Log_Conf_Handle.

Si CM_Get_First_Log_Conf est appelé avec plcLogConf défini sur NULL, aucun handle n’est retourné. Cela vous permet d’utiliser la status de retour pour déterminer si une configuration existe sans avoir à libérer le handle par la suite.

Pour plus d’informations sur l’utilisation de handles de instance d’appareil liés à l’ordinateur local, consultez CM_Get_Child.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Disponible dans Microsoft Windows 2000 et versions ultérieures de Windows.
Plateforme cible	Desktop (Expérience utilisateur)
En-tête	cfgmgr32.h (inclure Cfgmgr32.h)
Bibliothèque	Cfgmgr32.lib
DLL	Cfgmgr32.dll