Funzione NotifyIpInterfaceChange
La funzione NotifyIpInterfaceChange registra il driver per ricevere una notifica per tutte le interfacce IP, le interfacce IPv4 o IPv6 in un computer locale.
Sintassi
NETIOAPI_API NotifyIpInterfaceChange(
_In_ ADDRESS_FAMILY Family,
_In_ PIPINTERFACE_CHANGE_CALLBACK Callback,
_In_ PVOID CallerContext,
_In_ BOOLEAN InitialNotification,
_Inout_ HANDLE *NotificationHandle
);
Parametri
Famiglia [in]
Famiglia di indirizzi in cui registrare il driver per le notifiche di modifica.I valori possibili per la famiglia di indirizzi sono elencati nel file di intestazione Winsock2.h. Si noti che i valori per la famiglia di indirizzi AF_ e le costanti della famiglia di protocolli di PF_ sono identiche (ad esempio, AF_INET e PF_INET), in modo da poter usare una costante.
In Windows Vista e versioni successive dei sistemi operativi Windows, i valori possibili per il parametro Family sono definiti nel file di intestazione Ws2def.h. Si noti che il file di intestazione Ws2def.h viene incluso automaticamente in Netioapi.h e non usare mai Ws2def.h direttamente.
I valori seguenti sono attualmente supportati per la famiglia di indirizzi:
AF_INET
Famiglia di indirizzi IPv4. Quando questo valore viene specificato, questa funzione registra il driver per ricevere una notifica solo per le notifiche di modifica IPv4.AF_INET6
Famiglia di indirizzi IPv6. Quando questo valore viene specificato, questa funzione registra il driver solo per le notifiche di modifica IPv6.AF_UNSPEC
La famiglia di indirizzi non è specificata. Quando questo valore viene specificato, questa funzione registra il driver per ricevere una notifica per le modifiche sia IPv4 che IPv6.
Callback [in]
Puntatore alla funzione da chiamare quando si verifica una modifica. Questa funzione viene chiamata quando viene ricevuta una notifica dell'interfaccia.CallerContext [in]
Contesto utente passato alla funzione di callback specificata nel parametro Callback quando viene ricevuta una notifica dell'interfaccia.InitialNotification [in]
Valore che indica se il callback deve essere richiamato immediatamente dopo il completamento della registrazione per la notifica delle modifiche. Questa notifica iniziale non indica che si è verificata una modifica a un'interfaccia IP. Scopo di questo parametro per fornire la conferma che il callback è registrato.NotificationHandle [in, out]
Puntatore usato per restituire un handle che può essere usato in un secondo momento per annullare la registrazione della notifica delle modifiche. In caso di esito positivo, viene restituito un handle di notifica in questo parametro. Se si verifica un errore, viene restituito NULL .
Valore restituito
NotifyIpInterfaceChange restituisce STATUS_SUCCESS se la funzione ha esito positivo.
Se la funzione ha esito negativo, NotifyIpInterfaceChange restituisce uno dei codici di errore seguenti:
| Codice restituito | Descrizione |
|---|---|
| ERROR_INVALID_HANDLE | Si è verificato un errore interno in cui è stato rilevato un handle non valido. |
| STATUS_INVALID_PARAMETER | Un parametro non valido è stato passato alla funzione. Questo errore viene restituito se il parametro Family non è AF_INET, AF_INET6 o AF_UNSPEC. |
| STATUS_NOT_ENOUGH_MEMORY | Memoria insufficiente. |
| Altri | Utilizzare la funzione FormatMessage per ottenere la stringa di messaggio per l'errore restituito. |
Commenti
Il driver deve impostare il parametro Family su AF_INET, AF_INET6 o AF_UNSPEC.
La chiamata della funzione di callback specificata nel parametro Callback viene serializzata. La funzione di callback deve essere definita come funzione di tipo VOID. I parametri passati alla funzione callback includono quanto segue.
| Parametro | Descrizione |
|---|---|
IN PVOID CallerContext |
Parametro CallerContext passato alla funzione NotifyIpInterfaceChange quando registra il driver per le notifiche di modifica. |
IN PMIB_IPINTERFACE_ROW riga FACOLTATIVA |
Puntatore alla voce MIB_IPINTERFACE_ROW per l'interfaccia modificata. Questo parametro è un puntatore NULL quando il valore MIB_NOTIFICATION_TYPE passato nel parametro NotificationType alla funzione di callback è impostato su MibInitialNotification. Questa situazione può verificarsi solo se il parametro InitialNotification passato a NotifyIpInterfaceChange è stato impostato su TRUE durante la registrazione del driver per le notifiche di modifica. |
IN MIB_NOTIFICATION_TYPE NotificationType |
Tipo di notifica. Questo membro può essere uno dei valori del tipo di enumerazione MIB_NOTIFICATION_TYPE . |
Per annullare la registrazione del driver per le notifiche di modifica, chiamare la funzione CancelMibChangeNotify2 , passando il parametro NotificationHandlerestituito da NotifyIpInterfaceChange .
Requisiti
Piattaforma di destinazione |
Universale |
Versione |
Disponibile in Windows Vista e versioni successive dei sistemi operativi Windows. |
Intestazione |
Netioapi.h (include Netioapi.h) |
Libreria |
Netio.lib |
IRQL |
< DISPATCH_LEVEL |