función CM_Get_HW_Prof_FlagsW (cfgmgr32.h)
[A partir de Windows 8 y Windows Server 2012, esta función está en desuso y no se debe usar.]
La función CM_Get_HW_Prof_Flags recupera el perfil de hardware marcas de configuración específicas para una instancia de dispositivo en un equipo local.
Sintaxis
CMAPI CONFIGRET CM_Get_HW_Prof_FlagsW(
[in] DEVINSTID_W pDeviceID,
[in] ULONG ulHardwareProfile,
[out] PULONG pulValue,
[in] ULONG ulFlags
);
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.
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 de CR_Xxx definidos en cfgmgr32.h.
Observaciones
Para recuperar una lista de identificadores de perfil de hardware definidos actualmente en un equipo local, llame a SetupDiGetHwProfileList.
Para recuperar marcas de configuración para una instancia de dispositivo en un equipo remoto, llame a CM_Get_HW_Prof_Flags_Ex.
Nota
El encabezado cfgmgr32.h define CM_Get_HW_Prof_Flags 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 |