funzione CM_Get_HW_Prof_Flags_ExA (cfgmgr32.h)

Articolo
08/22/2023

[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.

Nota L'uso di questa funzione per accedere ai computer remoti non è supportato a partire da Windows 8 e Windows Server 2012, perché questa funzionalità è stata rimossa.

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

Vedi anche

CM_Get_HW_Prof_Flags

SetupDiGetHwProfileFriendlyNameEx

SetupDiGetHwProfileListEx

Condividi tramite