función CM_Get_HW_Prof_FlagsA (cfgmgr32.h)

[A partir de Windows 8 y Windows Server 2012, esta función ha quedado en desuso y no debe usarse.]

La función CM_Get_HW_Prof_Flags recupera las marcas de configuración específicas del perfil de hardware para una instancia de dispositivo en un equipo local.

Sintaxis

CMAPI CONFIGRET CM_Get_HW_Prof_FlagsA(
  [in]  DEVINSTID_A 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 CR_Xxx definidos en Cfgmgr32.h.

Comentarios

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 de 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 neutro de codificación con código que no es neutral de codificación puede provocar discrepancias que dan lugar a errores de compilación o en tiempo de ejecución. Para obtener más información, vea Convenciones para prototipos de función.

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_Get_HW_Prof_Flags_Ex

SetupDiGetHwProfileFriendlyName

SetupDiGetHwProfileList