función CM_Add_ID_ExA (cfgmgr32.h)

[A partir de Windows 8 y Windows Server 2012, esta función ha quedado en desuso. Use CM_Add_ID en su lugar.

La función CM_Add_ID_Ex anexa un identificador de dispositivo (si aún no está presente) a la lista de identificadores de hardware de una instancia de dispositivo o a la lista de identificadores compatibles , en la máquina local o remota.

Sintaxis

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

Parámetros

dnDevInst

Identificador de instancia de dispositivo proporcionado por el autor de la llamada que está enlazado al controlador de máquina proporcionado por hMachine.

pszID

Puntero proporcionado por el autor de la llamada a una cadena de identificador de dispositivo terminada en NULL.

ulFlags

Constante de marca proporcionada por el autor de la llamada que especifica la lista en la que se debe anexar el identificador de dispositivo proporcionado. Las siguientes constantes de marca son válidas.

Flag (constante)	Definición
CM_ADD_ID_COMPATIBLE	El identificador de dispositivo especificado debe anexarse a la lista de identificadores compatibles de la instancia de dispositivo específica.
CM_ADD_ID_HARDWARE	El identificador de dispositivo especificado debe anexarse a la lista de identificadores de hardware de la instancia de dispositivo específica.

hMachine

Identificador de máquina proporcionado por el autor de la llamada al que está enlazado el identificador de instancia de dispositivo proporcionado por el autor de la llamada.

Nota No se admite el uso de esta función para acceder a máquinas remotas a partir de Windows 8 y Windows Server 2012, ya que esta funcionalidad se ha quitado.

 

Valor devuelto

Si la operación se realiza correctamente, la función devuelve CR_SUCCESS. De lo contrario, devuelve uno de los códigos de error con prefijo CR_ definidos en Cfgmgr32.h.

Comentarios

Cada identificador de dispositivo anexado se considera menos compatible que los identificadores que ya existen en la lista especificada. Para obtener información sobre los identificadores de dispositivo, los identificadores de hardware y los identificadores compatibles, consulte Cadenas de identificación de dispositivos.

Los autores de llamadas de esta función deben tener SeLoadDriverPrivilege. (Los privilegios se describen en la documentación de Microsoft Windows SDK).

Para obtener información sobre el uso de identificadores de instancia de dispositivo enlazados a un equipo local o remoto, consulte CM_Get_Child_Ex.

La funcionalidad para acceder a las máquinas remotas se ha quitado en Windows 8 y sistemas operativos Windows Server 2012 y versiones posteriores, por lo que no se puede acceder a las máquinas remotas cuando se ejecutan en estas versiones de Windows.

Requisitos

Requisito	Value
Cliente mínimo compatible	Disponible en Microsoft Windows 2000 y versiones posteriores de Windows.
Plataforma de destino	Escritorio
Encabezado	cfgmgr32.h (incluya Cfgmgr32.h)
Library	Cfgmgr32.lib

Consulte también

CM_Add_ID
CM_Get_Child_Ex