Função CM_Get_Next_Log_Conf_Ex (cfgmgr32.h)

[Começando com Windows 8 e Windows Server 2012, essa função foi preterida. Em vez disso, use CM_Get_Next_Log_Conf .]

A função CM_Get_Next_Log_Conf_Ex obtém a próxima configuração lógica associada a uma instância de dispositivo específica em um computador local ou remoto.

Sintaxe

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

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] lcLogConf

Identificador fornecido pelo chamador para uma configuração lógica. Esse identificador deve ter sido obtido anteriormente chamando uma das seguintes funções:

CM_Get_First_Log_Conf_Ex

CM_Get_Next_Log_Conf_Ex

[in] ulFlags

Não usado, deve ser zero.

[in, optional] hMachine

Identificador de computador fornecido pelo chamador, obtido de uma chamada anterior para CM_Connect_Machine.

Nota Não há suporte para o uso dessa função para acessar computadores remotos, começando com Windows 8 e Windows Server 2012, pois essa funcionalidade foi removida.

 

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.

Nota Começando com Windows 8, CM_Get_Next_Log_Conf_Ex retorna CR_CALL_NOT_IMPLEMENTED quando usado em um cenário Wow64. Para solicitar informações sobre os recursos de hardware em um computador local, é necessário implementar uma versão nativa da arquitetura do aplicativo usando as APIs de recurso de hardware. Por exemplo: um aplicativo AMD64 para sistemas AMD64.

 

Comentários

Para enumerar as configurações lógicas associadas a uma instância de dispositivo, chame CM_Get_First_Log_Conf_Ex para obter a primeira configuração lógica e, em seguida, chame CM_Get_Next_Log_Conf_Ex repetidamente até que ela retorne CR_NO_MORE_LOG_CONF.

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

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

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

A funcionalidade para acessar computadores remotos foi removida em Windows 8 e Windows Server 2012 e sistemas operacionais posteriores, portanto, você não pode acessar computadores remotos durante a execução nessas versões do Windows.

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Disponível no Microsoft Windows 2000 e versões posteriores do Windows.
Plataforma de Destino	Área de Trabalho
Cabeçalho	cfgmgr32.h (inclua Cfgmgr32.h)
Biblioteca	Cfgmgr32.lib
DLL	Cfgmgr32.dll

Confira também

CM_Get_Next_Log_Conf