CM_Free_Log_Conf-Funktion (cfgmgr32.h)
Die funktion CM_Free_Log_Conf entfernt eine logische Konfiguration und alle zugehörigen Ressourcendeskriptoren vom lokalen Computer.
Syntax
CMAPI CONFIGRET CM_Free_Log_Conf(
[in] LOG_CONF lcLogConfToBeFreed,
[in] ULONG ulFlags
);
Parameter
[in] lcLogConfToBeFreed
Vom Aufrufer bereitgestelltes Handle für eine logische Konfiguration. Dieses Handle muss zuvor durch Aufrufen einer der folgenden Funktionen abgerufen worden sein:
[in] ulFlags
Nicht verwendet, muss null sein.
Rückgabewert
Wenn der Vorgang erfolgreich ist, gibt die Funktion CR_SUCCESS zurück. Andernfalls wird einer der in Cfgmgr32.h definierten Fehlercodes mit CR_ Präfix zurückgegeben.
Hinweise
Das Aufrufen CM_Free_Log_Conf kann dazu führen, dass die von CM_Get_First_Log_Conf zurückgegebenen Handles und CM_Get_Next_Log_Conf ungültig werden. Wenn Sie also logische Konfigurationen nach dem Aufruf CM_Free_Log_Conf abrufen möchten, muss Ihr Code CM_Get_First_Log_Conf erneut aufrufen und bei der ersten Konfiguration beginnen.
Beachten Sie, dass der Aufruf CM_Free_Log_Conf die Konfiguration freigibt, aber nicht das Handle der Konfiguration. Rufen Sie CM_Free_Log_Conf_Handle auf, um das Handle frei zu geben.
Aufrufer dieser Funktion müssen über SeLoadDriverPrivilege verfügen. (Berechtigungen werden in der dokumentation Microsoft Windows SDK beschrieben.)
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) | Verfügbar in Microsoft Windows 2000 und höheren Versionen von Windows. |
| Zielplattform | Desktop |
| Kopfzeile | cfgmgr32.h (include Cfgmgr32.h) |
| Bibliothek | Cfgmgr32.lib |
| DLL | Cfgmgr32.dll |