funzione CM_Get_HW_Prof_Flags_ExW (cfgmgr32.h)
[Questa funzione è stata deprecata e non deve essere usata.]
La funzione CM_Get_HW_Prof_Flags_Ex recupera i flag di configurazione specifici del profilo hardware per un'istanza del dispositivo in un computer remoto o in un computer locale.
Sintassi
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
);
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 cui 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
Impossibile avviare il dispositivo nel profilo hardware specificato.
[in] ulFlags
Riservato per utilizzo interno. Deve essere impostato su zero.
[in, optional] hMachine
Handle di computer restituito dalla chiamata a CM_Connect_Machine o NULL. Se questo parametro è impostato su NULL, CM_Get_HW_Prof_Flags_Ex recupera i flag di configurazione nel computer locale.
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 con prefisso CR_ definiti in Cfgmgr32.h.
Commenti
Per recuperare un elenco degli ID del profilo hardware attualmente definiti in un computer remoto, chiamare SetupDiGetHwProfileListEx.
La funzionalità per accedere ai computer remoti è stata rimossa in Windows 8 e Windows Server 2012 e sistemi operativi successivi, pertanto non è possibile accedere ai computer remoti quando vengono eseguiti in queste versioni di Windows.
Nota
L'intestazione cfgmgr32.h definisce CM_Get_HW_Prof_Flags_Ex come alias che seleziona automaticamente la versione ANSI o Unicode di questa funzione in base alla definizione della costante preprocessore UNICODE. La combinazione dell'utilizzo dell'alias di codifica neutrale con il codice che non è neutrale dalla codifica può causare errori di corrispondenza che causano errori di compilazione o runtime. Per altre informazioni, vedere Convenzioni per i prototipi di funzione.
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 |