funzione CM_Free_Log_Conf (cfgmgr32.h)

  • Articolo

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:

CM_Add_Empty_Log_Conf

CM_Add_Empty_Log_Conf_Ex

CM_Get_First_Log_Conf

CM_Get_First_Log_Conf_Ex

CM_Get_Next_Log_Conf

CM_Get_Next_Log_Conf_Ex

[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.

Nota A partire da Windows 8, CM_Free_Log_Conf restituisce CR_CALL_NOT_IMPLEMENTED quando viene usato in uno scenario Wow64. Per richiedere informazioni sulle risorse hardware in un computer locale, è necessario implementare una versione nativa dell'architettura dell'applicazione usando le API delle risorse hardware. Ad esempio: un'applicazione AMD64 per sistemi AMD64.
 

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

Vedi anche

CM_Free_Log_Conf_Ex