funzione CM_Add_Empty_Log_Conf (cfgmgr32.h)
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.
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 |