funzione CM_Get_First_Log_Conf (cfgmgr32.h)

  • Articolo

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.

Nota A partire da Windows 8, CM_Get_First_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 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

Vedi anche

CM_Add_Empty_Log_Conf

CM_Free_Log_Conf

CM_Free_Log_Conf_Handle

CM_Get_Child

CM_Get_First_Log_Conf_Ex