Funzione CancelMibChangeNotify2 (netioapi.h)
La funzione CancelMibChangeNotify2 deregisters per le notifiche di modifica per le modifiche all'interfaccia IP, le modifiche all'indirizzo IP, le modifiche alla route IP Teredo modifiche alla porta e quando la tabella degli indirizzi IP unicast è stabile e può essere recuperata.
Sintassi
IPHLPAPI_DLL_LINKAGE NETIOAPI_API CancelMibChangeNotify2(
[in] HANDLE NotificationHandle
);
Parametri
[in] NotificationHandle
Handle restituito da una registrazione di notifica o funzione di recupero per indicare quale notifica annullare.
Valore restituito
Se la funzione ha esito positivo, il valore restituito viene NO_ERROR.
Se la funzione ha esito negativo, il valore restituito è uno dei codici di errore seguenti.
| Codice restituito | Descrizione |
|---|---|
|
Alla funzione è stato passato un parametro non valido. Questo errore viene restituito se il parametro NotificationHandle è un puntatore NULL . |
|
Usare FormatMessage per ottenere la stringa del messaggio per l'errore restituito. |
Commenti
La funzione CancelMibChangeNotify2 viene definita in Windows Vista e versioni successive.
The
CancelMibChangeNotify2 deregisters per una notifica di modifica richiesta in precedenza per le modifiche all'interfaccia IP, modifiche all'indirizzo IP, modifiche della route IP o modifiche della porta Teredo in un computer locale. Queste richieste vengono effettuate chiamando NotifyIpInterfaceChange, NotifyUnicastIpAddressChange, NotifyRouteChange2 o NotifyTeredoPortChange. The
La funzione CancelMibChangeNotify2 annulla anche una richiesta precedente per ricevere una notifica quando la tabella degli indirizzi IP unicast è stabile in un computer locale e può essere recuperata. Questa richiesta viene effettuata chiamando la funzione NotifyStableUnicastIpAddressTable .
Il parametro NotificationHandle restituito a queste funzioni di notifica viene passato a CancelMibChangeNotify2 per annullare la registrazione per le notifiche o annullare una richiesta in sospeso per recuperare la tabella degli indirizzi IP unicast stabile.
Un'applicazione non può effettuare una chiamata alla funzione CancelMibChangeNotify2 dal contesto del thread che sta attualmente eseguendo la funzione di callback di notifica per lo stesso parametro NotificationHandle . In caso contrario, il thread che esegue il callback genererà un deadlock. Pertanto, la funzione CancelMibChangeNotify2 non deve essere chiamata direttamente come parte della routine di callback di notifica. In una situazione più generale, un thread che esegue la funzione CancelMibChangeNotify2 non può essere proprietario di una risorsa in cui il thread che esegue un'operazione di callback di notifica attenderebbe perché genera un deadlock simile. La funzione CancelMibChangeNotify2 deve essere chiamata da un thread diverso, in cui il thread che riceve il callback di notifica non ha dipendenze.
Requisiti
| Requisito | Valore |
|---|---|
| Client minimo supportato | Windows Vista [app desktop | App UWP] |
| Server minimo supportato | Windows Server 2008 [app desktop | App UWP] |
| Piattaforma di destinazione | Windows |
| Intestazione | netioapi.h (include Iphlpapi.h) |
| Libreria | Iphlpapi.lib |
| DLL | Iphlpapi.dll |