función CM_Get_HW_Prof_Flags_ExW (cfgmgr32.h)

  • Artículo

[Esta función está en desuso y no se debe usar.]

La función CM_Get_HW_Prof_Flags_Ex recupera las marcas de configuración específicas del perfil de hardware para una instancia de dispositivo en un equipo remoto o en una máquina local.

Sintaxis

CMAPI CONFIGRET CM_Get_HW_Prof_Flags_ExW(
  [in]           DEVINSTID_W 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.

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, CM_Get_HW_Prof_Flags devuelve CR_SUCCESS. De lo contrario, la función devuelve uno de los códigos de error con prefijo CR_ definidos en Cfgmgr32.h.

Comentarios

Para recuperar una lista de los identificadores de perfil de hardware que están definidos actualmente en un equipo remoto, llame a SetupDiGetHwProfileListEx.

La funcionalidad para acceder a las 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 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

SetupDiGetHwProfileFriendlyNameEx

SetupDiGetHwProfileListEx