funzione CM_Reenumerate_DevNode_Ex (cfgmgr32.h)
[A partire da Windows 8 e Windows Server 2012, questa funzione è stata deprecata. Usare invece CM_Reenumerate_DevNode .]
La funzione CM_Reenumerate_DevNode_Ex enumera i dispositivi identificati da un nodo dispositivo specificato e tutti i relativi elementi figlio.
CMAPI CONFIGRET CM_Reenumerate_DevNode_Ex(
[in] DEVINST dnDevInst,
[in] ULONG ulFlags,
[in, optional] HMACHINE hMachine
);
[in] dnDevInst
Handle di istanza del dispositivo fornito dal chiamante associato all'handle del computer fornito da hMachine.
[in] ulFlags
Flag forniti dal chiamante che specificano il modo in cui deve verificarsi la rinumerazione. Questo parametro può essere impostato su una combinazione dei flag seguenti, come indicato di seguito:
La rinumerazione deve verificarsi in modo asincrono. La chiamata a questa funzione viene restituita immediatamente dopo che la gestione PnP riceve la richiesta di rinumerazione. Se questo flag è impostato, il flag di CM_REENUMERATE_SYNCHRONOUS non deve essere impostato anche.
Specifica il comportamento di rinumerazione predefinito, in cui la rinumerazione si verifica in modo sincrono. Questo flag è attualmente equivalente a CM_REENUMERATE_SYNCHRONOUS.
Specifica che Plug and Play deve eseguire un altro tentativo di installare tutti i dispositivi nel sottoalbero specificato rilevati, ma non ancora configurati o contrassegnati come necessario reinstallare o per il quale è necessario completare l'installazione. Questo flag può essere impostato insieme al flag CM_REENUMERATE_SYNCHRONOUS o al flag di CM_REENUMERATE_ASYNCHRONOUS.
Questo flag deve essere usato con attenzione estrema, perché può causare che il gestore PnP debba richiedere all'utente di eseguire l'installazione di tali dispositivi. Attualmente, solo i componenti come Gestione dispositivi e La creazione guidata hardware usano questo flag, per consentire all'utente di riprovare l'installazione dei dispositivi che potrebbero essere già stati rilevati, ma non sono attualmente installati.
La rinumerazione deve verificarsi in modo sincrono. La chiamata a questa funzione restituisce quando tutti i dispositivi nel sottoalbero specificato sono stati rinumerati. Se questo flag è impostato, il flag di CM_REENUMERATE_ASYNCHRONOUS non deve essere impostato anche. Questo flag è attualmente equivalente a CM_REENUMERATE_NORMAL.
[in, optional] hMachine
Handle del computer fornito dal chiamante a cui è associato l'handle dell'istanza del chiamante fornito dal chiamante.
Se l'operazione ha esito positivo, la funzione restituisce CR_SUCCESS. In caso contrario, restituisce uno dei codici di errore con prefisso CR_ definiti in Cfgmgr32.h.
Se il nodo dispositivo specificato rappresenta un dispositivo hardware o software bus, il gestore PnP esegue una query sui driver del dispositivo per un elenco di elementi figlio, quindi tenta di configurare e avviare tutti i dispositivi figlio che non sono stati configurati in precedenza. Il gestore PnP avvia anche la rimozione a sorpresa dei dispositivi che non sono più presenti (vedere IRP_MN_SURPRISE_REMOVAL).
I chiamanti di questa funzione devono avere SeLoadDriverPrivilege. I privilegi sono descritti nella documentazione di Microsoft Windows SDK.
Per informazioni sull'uso degli handle di istanza del dispositivo associati a un computer locale o remoto, vedere CM_Get_Child_Ex.
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.
| 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 |
| DLL | Cfgmgr32.dll |