função CM_Add_IDW (cfgmgr32.h)

A função CM_Add_ID acrescenta uma ID de dispositivo especificada (se ainda não estiver presente) à lista de IDs de hardware ou à lista de IDs compatíveisde uma instância do dispositivo.

Sintaxe

CMAPI CONFIGRET CM_Add_IDW(
  [in] DEVINST dnDevInst,
  [in] PWSTR   pszID,
  [in] ULONG   ulFlags
);

Parâmetros

[in] dnDevInst

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

[in] pszID

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

[in] ulFlags

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

Constante de 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 de dispositivo específica.

Valor retornado

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

A função CM_Add_ID só pode ser usada quando dnDevInst representa um dispositivo enumerado por raiz. Para outros dispositivos, o motorista do barramento relata hardware e IDs compatíveis ao enumerar um dispositivo filho após receber IRP_MN_QUERY_ID.

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 ao computador local, consulte CM_Get_Child.

Requisitos

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_Ex

CM_Get_Child