funzione CM_Get_First_Log_Conf (cfgmgr32.h)
La funzione CM_Get_First_Log_Conf ottiene la prima configurazione logica, di un tipo di configurazione specificato, associata a un'istanza del dispositivo specificata nel computer locale.
Sintassi
CMAPI CONFIGRET CM_Get_First_Log_Conf(
[out, optional] PLOG_CONF plcLogConf,
[in] DEVINST dnDevInst,
[in] ULONG ulFlags
);
Parametri
[out, optional] plcLogConf
Indirizzo di una posizione in cui ricevere l'handle a una configurazione logica o NULL. Vedere la sezione Osservazioni seguente.
[in] dnDevInst
Handle dell'istanza del dispositivo fornita dal chiamante associato al computer locale.
[in] ulFlags
Valore del flag fornito dal chiamante che indica il tipo di configurazione logica richiesta. È necessario specificare uno dei flag nella tabella seguente.
| Flag del tipo di configurazione | Definizioni |
|---|---|
| BASIC_LOG_CONF | Il chiamante richiede informazioni di configurazione di base . |
| FILTERED_LOG_CONF | Il chiamante richiede informazioni di configurazione filtrate . |
| ALLOC_LOG_CONF | Il chiamante richiede informazioni di configurazione allocate . |
| BOOT_LOG_CONF | Il chiamante richiede informazioni di configurazione di avvio . |
| FORCED_LOG_CONF | Il chiamante richiede informazioni di configurazione forzata . |
| OVERRIDE_LOG_CONF | Il chiamante richiede informazioni di configurazione di sostituzione . |
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 a CM_Add_Empty_Log_Conf o CM_Free_Log_Conf può invalidare l'handle ottenuto da una chiamata precedente a CM_Get_First_Log_Conf. Pertanto, se si desidera ottenere configurazioni logiche dopo aver chiamato CM_Add_Empty_Log_Conf o CM_Free_Log_Conf, il codice deve chiamare di nuovo CM_Get_First_Log_Conf e iniziare alla prima configurazione.
La maniglia ricevuta in plcLogConf deve essere liberata esplicitamente chiamando CM_Free_Log_Conf_Handle.
Se CM_Get_First_Log_Conf viene chiamato con plcLogConf impostato su NULL, non viene restituito alcun handle. In questo modo è possibile usare lo stato restituito per determinare se esiste una configurazione senza la necessità di liberare successivamente l'handle.
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 |