função CM_Add_Empty_Log_Conf_Ex (cfgmgr32.h)

Artigo
02/26/2024

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

A função CM_Add_Empty_Log_Conf_Ex cria uma configuração lógica vazia, para um tipo de configuração especificado e uma instância de dispositivo especificada, no computador local ou remoto.

Sintaxe

CMAPI CONFIGRET CM_Add_Empty_Log_Conf_Ex(
  [out]          PLOG_CONF plcLogConf,
  [in]           DEVINST   dnDevInst,
  [in]           PRIORITY  Priority,
  [in]           ULONG     ulFlags,
  [in, optional] HMACHINE  hMachine
);

Parâmetros

[out] plcLogConf

Ponteiro para um local para receber o identificador para uma configuração lógica vazia.

[in] dnDevInst

Identificador de instância de dispositivo fornecido pelo chamador associado ao identificador do computador fornecido pelo hMachine.

[in] Priority

Valor de prioridade de configuração fornecido pelo chamador. Para obter uma lista de valores, consulte a Descrição de prioridade para CM_Add_Empty_Log_Conf.

[in] ulFlags

Sinalizadores fornecidos pelo chamador que especificam o tipo da configuração lógica. Para obter uma lista de sinalizadores, consulte a descrição ulFlags description para CM_Add_Empty_Log_Conf.

[in, optional] hMachine

Identificador de computador fornecido pelo chamador ao qual o identificador de instância do dispositivo fornecido pelo chamador está associado.

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_Add_Empty_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

Chamar CM_Add_Empty_Log_Conf_Ex pode fazer com que os identificadores retornados por CM_Get_First_Log_Conf_Ex e CM_Get_Next_Log_Conf_Ex se tornem inválidos. Portanto, se você quiser obter configurações lógicas depois de chamar CM_Add_Empty_Log_Conf_Ex, seu código deverá chamar CM_Get_First_Log_Conf_Ex novamente e começar na primeira configuração.

Para remover uma configuração lógica criada por CM_Add_Empty_Log_Conf_Ex, chame CM_Free_Log_Conf_Ex.

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

Os chamadores dessa função devem ter SeLoadDriverPrivilege. (Os privilégios são descritos na documentação do SDK do Microsoft Windows.)

Para obter informações sobre como usar identificadores de instância de dispositivo associados a um computador local ou remoto, consulte CM_Get_Child_Ex.

A funcionalidade para acessar computadores remotos foi removida em sistemas operacionais Windows 8 e Windows Server 2012 e 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