Compartilhar via


Função CM_Add_ID_ExW (cfgmgr32.h)

[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 de dispositivo (se ainda não estiver presente) à lista de IDs de hardware ou à lista de IDs compatíveis de uma instância de dispositivo, no computador local ou remoto.

Sintaxe

CMAPI CONFIGRET CM_Add_ID_ExW(
  [in]           DEVINST  dnDevInst,
  [in]           PWSTR    pszID,
  [in]           ULONG    ulFlags,
  [in, optional] HMACHINE hMachine
);

Parâmetros

[in] dnDevInst

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

hMachine

.

[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.

[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.

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

Confira também

CM_Add_ID

CM_Get_Child_Ex