funzione CM_Get_HW_Prof_Flags_ExA (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_ExA(
[in] DEVINSTID_A 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 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.
[in, optional] hMachine
Handle del 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.
Le funzionalità per accedere ai computer remoti sono state rimosse nei sistemi operativi Windows 8 e Windows Server 2012 e versioni successive, pertanto non è possibile accedere ai computer remoti durante l'esecuzione 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 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
| 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 |