funzione CM_Get_HW_Prof_FlagsW (cfgmgr32.h)

  • Articolo

[A partire da Windows 8 e Windows Server 2012, questa funzione è stata deprecata e non deve essere usata.]

La funzione CM_Get_HW_Prof_Flags recupera i flag di configurazione specifici del profilo hardware per un'istanza del dispositivo in un computer locale.

Sintassi

CMAPI CONFIGRET CM_Get_HW_Prof_FlagsW(
  [in]  DEVINSTID_W pDeviceID,
  [in]  ULONG       ulHardwareProfile,
  [out] PULONG      pulValue,
  [in]  ULONG       ulFlags
);

Parametri

[in] pDeviceID

Puntatore a una stringa con terminazione NULL che contiene l'ID istanza del dispositivo per cui recuperare i flag di configurazione specifici del profilo hardware.

[in] ulHardwareProfile

Variabile di tipo ULONG che specifica l'identificatore del profilo hardware per il quale recuperare i flag di configurazione. Se questo parametro è zero, questa funzione recupera i flag di configurazione per il profilo hardware corrente.

[out] pulValue

Puntatore a una variabile fornita dal chiamante di tipo ULONG che riceve zero o un OR bit per bit dei flag di configurazione seguenti definiti in Regstr.h:

CSCONFIGFLAG_BITS

OR bit per bit degli altri flag di CSCONFIGFLAG_Xxx.

CSCONFIGFLAG_DISABLE

L'istanza del dispositivo è disabilitata nel profilo hardware specificato.

CSCONFIGFLAG_DO_NOT_CREATE

Il profilo hardware non supporta l'istanza del dispositivo specificata.

CSCONFIGFLAG_DO_NOT_START

Il dispositivo non può essere avviato nel profilo hardware specificato.

[in] ulFlags

Riservato per utilizzo interno. Deve essere impostato su zero.

Valore restituito

Se l'operazione ha esito positivo, CM_Get_HW_Prof_Flags restituisce CR_SUCCESS. In caso contrario, la funzione restituisce uno dei codici di errore CR_Xxx definiti in Cfgmgr32.h.

Commenti

Per recuperare un elenco di ID profilo hardware attualmente definiti in un computer locale, chiamare SetupDiGetHwProfileList.

Per recuperare i flag di configurazione per un'istanza del dispositivo in un computer remoto, chiamare CM_Get_HW_Prof_Flags_Ex.

Nota

L'intestazione cfgmgr32.h definisce CM_Get_HW_Prof_Flags come alias che seleziona automaticamente la versione ANSI o Unicode di questa funzione in base alla definizione della costante del preprocessore UNICODE. La combinazione dell'utilizzo dell'alias indipendente dalla codifica con il codice che non è indipendente dalla codifica può causare mancate corrispondenze che generano errori di compilazione o di runtime. Per altre informazioni, vedere Convenzioni per i prototipi di funzioni.

Requisiti

Requisito Valore
Client minimo supportato Disponibile in Microsoft Windows 2000 e versioni successive di Windows.
Piattaforma di destinazione Desktop
Intestazione cfgmgr32.h (include Cfgmgr32.h)
Libreria Cfgmgr32.lib

Vedi anche

CM_Get_HW_Prof_Flags_Ex

SetupDiGetHwProfileFriendlyName

SetupDiGetHwProfileList