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 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 contenente l'ID dell'istanza del dispositivo 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 uso 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.
Osservazioni
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 non indipendente dalla codifica può causare mancate corrispondenze che generano errori di compilazione o di runtime. Per altre informazioni, vedere convenzioni di per i prototipi di funzioni.
Fabbisogno
| 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 |