funzione CM_Get_Next_Log_Conf (cfgmgr32.h)

Articolo
03/08/2023

La funzione CM_Get_Next_Log_Conf ottiene la configurazione logica successiva associata a un'istanza specifica del dispositivo nel computer locale.

Sintassi

CMAPI CONFIGRET CM_Get_Next_Log_Conf(
  [out, optional] PLOG_CONF plcLogConf,
  [in]            LOG_CONF  lcLogConf,
  [in]            ULONG     ulFlags
);

Parametri

[out, optional] plcLogConf

Indirizzo di un percorso per ricevere l'handle in una configurazione logica o NULL. Vedere la sezione Osservazioni seguenti.

[in] lcLogConf

Handle fornito dal chiamante a una configurazione logica. Questo handle deve essere stato ottenuto in precedenza chiamando una delle funzioni seguenti:

CM_Get_First_Log_Conf

CM_Get_Next_Log_Conf

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

Per enumerare le configurazioni logiche associate a un'istanza del dispositivo, chiamare CM_Get_First_Log_Conf per ottenere la prima configurazione logica di un tipo di configurazione specificato, quindi chiamare ripetutamente CM_Get_Next_Log_Conf finché non restituisce CR_NO_MORE_LOG_CONF.

La chiamata CM_Add_Empty_Log_Conf o CM_Free_Log_Conf può invalidare l'handle ottenuto da una chiamata precedente a CM_Get_Next_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.

L'handle ricevuto in plcLogConf deve essere liberato in modo esplicito chiamando CM_Free_Log_Conf_Handle.

Se CM_Get_Next_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.

Requisiti


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_Get_Next_Log_Conf_Ex

Condividi tramite