fonction CM_Get_First_Log_Conf (cfgmgr32.h)
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.
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 |