função CM_Add_ID_ExA (cfgmgr32.h)

  • Artigo

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

A função CM_Add_ID_Ex acrescenta uma ID do dispositivo (se ainda não estiver presente) à lista de IDs de hardware ou à lista de IDs compatíveis de uma instância do dispositivo, no computador local ou remoto.

Sintaxe

CMAPI CONFIGRET CM_Add_ID_ExA(
  DEVINST  dnDevInst,
  PSTR     pszID,
  ULONG    ulFlags,
  HMACHINE hMachine
);

Parâmetros

dnDevInst

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

pszID

Ponteiro fornecido pelo chamador para uma cadeia de caracteres de ID do dispositivo terminada em NULL.

ulFlags

Constante de sinalizador fornecida pelo chamador que especifica a lista na qual a ID do dispositivo fornecida deve ser acrescentada. As seguintes constantes de sinalizador são válidas.

Constante sinalizador Definição
CM_ADD_ID_COMPATIBLE A ID do dispositivo especificada deve ser acrescentada à lista de IDs compatíveis da instância de dispositivo específica.
CM_ADD_ID_HARDWARE A ID do dispositivo especificada deve ser acrescentada à lista de IDs de hardware da instância do dispositivo específica.

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.

Comentários

Cada ID de dispositivo acrescentada é considerada menos compatível do que as IDs já existentes na lista especificada. Para obter informações sobre IDs de dispositivo, IDs de hardware e IDs compatíveis, consulte Cadeias de caracteres de identificação do dispositivo.

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

Confira também

CM_Add_ID
CM_Get_Child_Ex