fonction CM_Free_Log_Conf (cfgmgr32.h)
La fonction CM_Free_Log_Conf supprime une configuration logique et tous les descripteurs de ressources associés de l’ordinateur local.
Syntaxe
CMAPI CONFIGRET CM_Free_Log_Conf(
[in] LOG_CONF lcLogConfToBeFreed,
[in] ULONG ulFlags
);
Paramètres
[in] lcLogConfToBeFreed
Handle fourni par l’appelant à une configuration logique. Ce handle doit avoir été obtenu précédemment en appelant l’une des fonctions suivantes :
[in] ulFlags
Non utilisé, doit être égal à zéro.
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 CM_Free_Log_Conf peut rendre non valides les handles retournés par CM_Get_First_Log_Conf et CM_Get_Next_Log_Conf. Par conséquent, si vous souhaitez obtenir des configurations logiques après avoir appelé CM_Free_Log_Conf, votre code doit appeler à nouveau CM_Get_First_Log_Conf et démarrer à la première configuration.
Notez que l’appel de CM_Free_Log_Conf libère la configuration, mais pas le handle de la configuration. Pour libérer le handle, appelez CM_Free_Log_Conf_Handle.
Les appelants de cette fonction doivent avoir SeLoadDriverPrivilege. (Les privilèges sont décrits dans la documentation Microsoft Windows SDK.)
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 |