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.

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

Vedi anche

NotifyIpInterfaceChange

NotifyRouteChange2

NotifyStableUnicastIpAddressTable

NotifyTeredoPortChange

NotifyUnicastIpAddressChange