función CM_Get_HW_Prof_Flags_ExA (cfgmgr32.h)
[Esta función ha quedado en desuso y no se debe usar.]
La función CM_Get_HW_Prof_Flags_Ex recupera el perfil de hardware marcas de configuración específicas para una instancia de dispositivo en un equipo remoto o en una máquina local.
Sintaxis
CMAPI CONFIGRET CM_Get_HW_Prof_Flags_ExA(
[in] DEVINSTID_A pDeviceID,
[in] ULONG ulHardwareProfile,
[out] PULONG pulValue,
[in] ULONG ulFlags,
[in, optional] HMACHINE hMachine
);
Parámetros
[in] pDeviceID
Puntero a una cadena terminada en NULL que contiene el identificador de instancia de dispositivo del dispositivo para el que se van a recuperar marcas de configuración específicas del perfil de hardware.
[in] ulHardwareProfile
Variable de tipo ULONG que especifica el identificador del perfil de hardware para el que se van a recuperar las marcas de configuración. Si este parámetro es cero, esta función recupera las marcas de configuración del perfil de hardware actual.
[out] pulValue
Puntero a una variable proporcionada por el autor de la llamada de tipo ULONG que recibe cero o un OR bit a bit de las siguientes marcas de configuración definidas en Regstr.h:
CSCONFIGFLAG_BITS
OR bit a bit de las demás marcas de CSCONFIGFLAG_Xxx.
CSCONFIGFLAG_DISABLE
La instancia del dispositivo está deshabilitada en el perfil de hardware especificado.
CSCONFIGFLAG_DO_NOT_CREATE
El perfil de hardware no admite la instancia de dispositivo especificada.
CSCONFIGFLAG_DO_NOT_START
El dispositivo no se puede iniciar en el perfil de hardware especificado.
[in] ulFlags
Reservado para uso interno. Debe establecerse en cero.
[in, optional] hMachine
Identificador de equipo devuelto por llamada a CM_Connect_Machine o NULL. Si este parámetro se establece en NULL, CM_Get_HW_Prof_Flags_Ex recupera las marcas de configuración en el equipo local.
Valor devuelto
Si la operación se realiza correctamente, CM_Get_HW_Prof_Flags devuelve CR_SUCCESS. De lo contrario, la función devuelve uno de los códigos de error CR_ prefijos definidos en Cfgmgr32.h.
Observaciones
Para recuperar una lista de los identificadores de perfil de hardware definidos actualmente en un equipo remoto, llame a SetupDiGetHwProfileListEx.
La funcionalidad para acceder a máquinas remotas se ha quitado en Windows 8 y Windows Server 2012 y sistemas operativos posteriores, por lo que no se puede acceder a las máquinas remotas cuando se ejecutan en estas versiones de Windows.
Nota
El encabezado cfgmgr32.h define CM_Get_HW_Prof_Flags_Ex como alias que selecciona automáticamente la versión ANSI o Unicode de esta función en función de la definición de la constante de preprocesador UNICODE. La combinación del uso del alias neutral de codificación con código que no es neutral de codificación puede dar lugar a errores de coincidencia que dan lugar a errores de compilación o tiempo de ejecución. Para obtener más información, vea Conventions for Function Prototypes.
Requisitos
| Requisito | Valor |
|---|---|
| cliente mínimo admitido | Disponible en Microsoft Windows 2000 y versiones posteriores de Windows. |
| de la plataforma de destino de |
Escritorio |
| encabezado de |
cfgmgr32.h (incluya Cfgmgr32.h) |
| biblioteca de |
Cfgmgr32.lib |