funzione CM_Free_Log_Conf (cfgmgr32.h)
La funzione CM_Free_Log_Conf rimuove una configurazione logica e tutti i descrittori di risorse associati dal computer locale.
Sintassi
CMAPI CONFIGRET CM_Free_Log_Conf(
[in] LOG_CONF lcLogConfToBeFreed,
[in] ULONG ulFlags
);
Parametri
[in] lcLogConfToBeFreed
Handle fornito dal chiamante a una configurazione logica. Questo handle deve essere stato ottenuto in precedenza chiamando una delle funzioni seguenti:
[in] ulFlags
Non usato, deve essere zero.
Valore restituito
Se l'operazione ha esito positivo, la funzione restituisce CR_SUCCESS. In caso contrario, restituisce uno dei codici di errore con prefisso CR_ definiti in Cfgmgr32.h.
Commenti
La chiamata CM_Free_Log_Conf può causare la non validità degli handle restituiti da CM_Get_First_Log_Conf e CM_Get_Next_Log_Conf. Pertanto, se si desidera ottenere configurazioni logiche dopo aver chiamato CM_Free_Log_Conf, il codice deve chiamare nuovamente CM_Get_First_Log_Conf e iniziare alla prima configurazione.
Si noti che la chiamata CM_Free_Log_Conf libera la configurazione, ma non la gestione della configurazione. Per liberare l'handle, chiamare CM_Free_Log_Conf_Handle.
I chiamanti di questa funzione devono avere SeLoadDriverPrivilege. I privilegi sono descritti nella documentazione di Microsoft Windows SDK.
Requisiti
| Requisito | Valore |
|---|---|
| Client minimo supportato | Disponibile in Microsoft Windows 2000 e versioni successive di Windows. |
| Piattaforma di destinazione | Desktop |
| Intestazione | cfgmgr32.h (include Cfgmgr32.h) |
| Libreria | Cfgmgr32.lib |
| DLL | Cfgmgr32.dll |