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.
Sintassi
CMAPI CONFIGRET CM_Reenumerate_DevNode_Ex(
[in] DEVINST dnDevInst,
[in] ULONG ulFlags,
[in, optional] HMACHINE hMachine
);
Parametri
[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:
CM_REENUMERATE_ASYNCHRONOUS
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.
CM_REENUMERATE_NORMAL
Specifica il comportamento di rinumerazione predefinito, in cui la rinumerazione si verifica in modo sincrono. Questo flag è attualmente equivalente a CM_REENUMERATE_SYNCHRONOUS.
CM_REENUMERATE_RETRY_INSTALLATION
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.
CM_REENUMERATE_SYNCHRONOUS
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.
Valore restituito
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.
Commenti
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.
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 |
| DLL | Cfgmgr32.dll |