CM_Get_Next_Log_Conf, fonction (cfgmgr32.h)
La fonction CM_Get_Next_Log_Conf obtient la configuration logique suivante associée à un appareil spécifique instance sur l’ordinateur local.
Syntaxe
CMAPI CONFIGRET CM_Get_Next_Log_Conf(
[out, optional] PLOG_CONF plcLogConf,
[in] LOG_CONF lcLogConf,
[in] ULONG ulFlags
);
Paramètres
[out, optional] plcLogConf
Adresse d’un emplacement pour recevoir le handle à une configuration logique, ou NULL. (Voir la section Remarques suivante.
[in] lcLogConf
Handle fourni par l’appelant à une configuration logique. Ce handle doit avoir été obtenu précédemment en appelant l’une des fonctions suivantes :
CM_Get_Next_Log_Conf
[in] ulFlags
Non utilisé, doit être égal à zéro.
Valeur retournée
Si l’opération réussit, la fonction retourne CR_SUCCESS. Sinon, elle retourne l’un des codes d’erreur préfixés CR_ définis dans Cfgmgr32.h.
Remarques
Pour énumérer les configurations logiques associées à un appareil instance, appelez CM_Get_First_Log_Conf pour obtenir la première configuration logique d’un type de configuration spécifié, puis appelez CM_Get_Next_Log_Conf à plusieurs reprises jusqu’à ce qu’elle retourne CR_NO_MORE_LOG_CONF.
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_Next_Log_Conf. Par conséquent, 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_Next_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 par la suite le handle.
Configuration requise
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 |
Voir aussi
Commentaires
https://aka.ms/ContentUserFeedback.
Bientôt disponible : Tout au long de 2024, nous allons supprimer progressivement GitHub Issues comme mécanisme de commentaires pour le contenu et le remplacer par un nouveau système de commentaires. Pour plus d’informations, consultezEnvoyer et afficher des commentaires pour