funzione CM_Add_Empty_Log_Conf (cfgmgr32.h)

Articolo
03/08/2023

La funzione CM_Add_Empty_Log_Conf crea una configurazione logica vuota, per un tipo di configurazione specificato e un'istanza del dispositivo specificata, nel computer locale.

Sintassi

CMAPI CONFIGRET CM_Add_Empty_Log_Conf(
  [out] PLOG_CONF plcLogConf,
  [in]  DEVINST   dnDevInst,
  [in]  PRIORITY  Priority,
  [in]  ULONG     ulFlags
);

Parametri

[out] plcLogConf

Indirizzo di una posizione per ricevere l'handle a una configurazione logica vuota.

[in] dnDevInst

Handle dell'istanza del dispositivo fornita dal chiamante associato al computer locale.

[in] Priority

Valore di priorità di configurazione fornito dal chiamante. Deve essere uno dei valori costanti elencati nella tabella seguente. Le costanti sono elencate in ordine di priorità, dal più alto al più basso. Per più configurazioni con lo stesso valore ulFlags , il sistema tenterà di usare quello con la priorità più alta per primo.

Costante Priority	Definizione
LCPRI_FORCECONFIG	Risultato di una configurazione forzata.
LCPRI_BOOTCONFIG	Risultato di una configurazione di avvio.
LCPRI_DESIRED	Configurazione preferita (prestazioni migliori).
LCPRI_NORMAL	Configurazione utilizzabile (prestazioni accettabili).
LCPRI_LASTBESTCONFIG	Solo per uso interno.
LCPRI_SUBOPTIMAL	Non è una configurazione auspicabile, ma funzionerà.
LCPRI_LASTSOFTCONFIG	Solo per uso interno.
LCPRI_RESTART	Il sistema deve essere riavviato
LCPRI_REBOOT	Il sistema deve essere riavviato (come LCPRI_RESTART).
LCPRI_POWEROFF	Il sistema deve essere arrestato e spento.
LCPRI_HARDRECONFIG	È necessario modificare un jumper.
LCPRI_HARDWIRED	Non è possibile modificare la configurazione.
LCPRI_IMPOSSIBLE	La configurazione non può esistere.
LCPRI_DISABLED	Configurazione disabilitata.

[in] ulFlags

Flag forniti dal chiamante che specificano il tipo di configurazione logica. È necessario specificare uno dei flag seguenti.

Flag del tipo di configurazione	Definizioni
BASIC_LOG_CONF	I descrittori di risorse aggiunti a questa configurazione descrivono una configurazione di base.
FILTERED_LOG_CONF	Non usare. Solo il gestore PnP può creare una configurazione filtrata.
ALLOC_LOG_CONF	Non usare. Solo il gestore PnP può creare una configurazione allocata.
BOOT_LOG_CONF	I descrittori di risorse aggiunti a questa configurazione descrivono una configurazione di avvio.
FORCED_LOG_CONF	I descrittori di risorse aggiunti a questa configurazione descrivono una configurazione forzata.
OVERRIDE_LOG_CONF	I descrittori di risorse aggiunti a questa configurazione descrivono una configurazione di override.

Uno dei flag di bit seguenti può essere ORed con il flag del tipo di configurazione.

Flag di confronto priorità	Definizioni
PRIORITY_EQUAL_FIRST	Se più configurazioni dello stesso tipo (ulFlags) hanno la stessa priorità (Priorità), questa configurazione viene posizionata all'inizio dell'elenco.
PRIORITY_EQUAL_LAST	(Impostazione predefinita) Se più configurazioni dello stesso tipo (ulFlags) hanno la stessa priorità (Priorità), questa configurazione viene posizionata nella parte finale dell'elenco.

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_Add_Empty_Log_Conf restituisce CR_CALL_NOT_IMPLEMENTED se 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_Add_Empty_Log_Conf può causare l'invalidità 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_Add_Empty_Log_Conf, il codice deve chiamare di nuovo CM_Get_First_Log_Conf e iniziare alla prima configurazione.

Per rimuovere una configurazione logica creata da CM_Add_Empty_Log_Conf, chiamare CM_Free_Log_Conf.

La maniglia ricevuta in plcLogConf deve essere liberata esplicitamente chiamando CM_Free_Log_Conf_Handle.

I chiamanti di questa funzione devono avere SeLoadDriverPrivilege. I privilegi sono descritti nella documentazione di Microsoft Windows SDK.

Per informazioni sull'uso di handle di istanza del dispositivo associati al computer locale, vedere CM_Get_Child.

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