funzione CM_Get_HW_Prof_FlagsA (cfgmgr32.h)
[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_FlagsA(
[in] DEVINSTID_A 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 |