função CM_Get_First_Log_Conf (cfgmgr32.h)

A função CM_Get_First_Log_Conf obtém a primeira configuração lógica, de um tipo de configuração especificado, associado a uma instância de dispositivo especificada no computador local.

Sintaxe

CMAPI CONFIGRET CM_Get_First_Log_Conf(
  [out, optional] PLOG_CONF plcLogConf,
  [in]            DEVINST   dnDevInst,
  [in]            ULONG     ulFlags
);

Parâmetros

[out, optional] plcLogConf

Endereço de um local para receber o identificador para uma configuração lógica ou NULL. Consulte a seção Comentários a seguir.

[in] dnDevInst

Identificador de instância de dispositivo fornecido pelo chamador associado ao computador local.

[in] ulFlags

Valor do sinalizador fornecido pelo chamador que indica o tipo de configuração lógica que está sendo solicitada. Um dos sinalizadores na tabela a seguir deve ser especificado.

Retornar valor

Se a operação for bem-sucedida, a função retornará CR_SUCCESS. Caso contrário, ele retornará um dos códigos de erro prefixados por CR_ definidos em Cfgmgr32.h.

Comentários

Chamar CM_Add_Empty_Log_Conf ou CM_Free_Log_Conf pode invalidar o identificador obtido de uma chamada anterior para CM_Get_First_Log_Conf. Portanto, se você quiser obter configurações lógicas depois de chamar CM_Add_Empty_Log_Conf ou CM_Free_Log_Conf, seu código deverá chamar CM_Get_First_Log_Conf novamente e começar na primeira configuração.

O identificador recebido em plcLogConf deve ser liberado explicitamente chamando CM_Free_Log_Conf_Handle.

Se CM_Get_First_Log_Conf for chamado com plcLogConf definido como NULL, nenhum identificador será retornado. Isso permite que você use o status de retorno para determinar se existe uma configuração sem a necessidade de liberar o identificador posteriormente.

Para obter informações sobre como usar identificadores de instância de dispositivo associados ao computador local, consulte CM_Get_Child.

Requisitos

Confira também

CM_Add_Empty_Log_Conf

CM_Free_Log_Conf

CM_Free_Log_Conf_Handle

CM_Get_Child

CM_Get_First_Log_Conf_Ex