Funzione NotifyTeredoPortChange (netioapi.h)

La funzione NotifyTeredoPortChange registra per ricevere una notifica per le modifiche apportate al numero di porta UDP utilizzato dal client Teredo per la porta del servizio Teredo in un computer locale.

Sintassi

IPHLPAPI_DLL_LINKAGE _NETIOAPI_SUCCESS_ NETIOAPI_API NotifyTeredoPortChange(
  [in]      PTEREDO_PORT_CHANGE_CALLBACK Callback,
  [in]      PVOID                        CallerContext,
  [in]      BOOLEAN                      InitialNotification,
  [in, out] HANDLE                       *NotificationHandle
);

Parametri

[in] Callback

Puntatore alla funzione da chiamare quando si verifica una modifica della porta client Teredo. Questa funzione verrà richiamata quando viene ricevuta una notifica di modifica della porta Teredo.

[in] CallerContext

Contesto utente passato alla funzione di callback specificata nel parametro Callback quando viene ricevuta una notifica di modifica della porta Teredo.

[in] InitialNotification

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 una modifica apportata alla porta client Teredo. Scopo di questo parametro per fornire la conferma che il callback è registrato.

[in, out] NotificationHandle

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

Se la funzione ha esito positivo, il valore restituito è NO_ERROR.

Se la funzione ha esito negativo, il valore restituito è uno dei codici di errore seguenti.

Commenti

La funzione NotifyTeredoPortChange viene definita in Windows Vista e versioni successive.

La funzione GetTeredoPort può essere usata per recuperare il numero di porta UDP iniziale usato dal client Teredo per la porta del servizio Teredo.

La porta Teredo è dinamica e può cambiare qualsiasi volta che il client Teredo viene riavviato nel computer locale. Un'applicazione può essere registrata per ricevere una notifica quando la porta del servizio Teredo cambia chiamando la funzione NotifyTeredoPortChange.

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:

La funzione di callback specificata nel parametro Callback deve essere implementata nello stesso processo dell'applicazione che chiama la funzione NotifyTeredoPortChange . Se la funzione di callback si trova in una DLL separata, la DLL deve essere caricata prima di chiamare la funzione NotifyTeredoPortChange per registrare le notifiche di modifica.

Dopo aver chiamato la funzione NotifyTeredoPortChange per la registrazione per le notifiche di modifica, queste notifiche continueranno a essere inviate fino a quando l'applicazione non deregisters per le notifiche di modifica o l'applicazione termina. Se l'applicazione termina, il sistema deregiregistrerà automaticamente qualsiasi registrazione per le notifiche di modifica. È comunque consigliabile che un'applicazione deregisteri in modo esplicito per le notifiche di modifica prima che venga terminata.

Qualsiasi registrazione per le notifiche di modifica non persiste in un sistema arrestato o riavviato.

Per annullare la registrazione delle notifiche delle modifiche, chiamare la funzione CancelMibChangeNotify2 passando il parametro NotificationHandle restituito da NotifyTeredoPortChange.

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 tale callback comporterà il 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 proprietaria di una risorsa in cui il thread che esegue un'operazione di callback di notifica attenderebbe perché comporta 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.

Il client Teredo usa anche la porta UDP statica 3544 per l'ascolto del traffico multicast inviato all'indirizzo IPv4 multicast 224.0.0.253 come definito in RFC 4380. Per altre informazioni, vedere http://www.ietf.org/rfc/rfc4380.txt.

La funzione NotifyTeredoPortChange viene usata principalmente dalle applicazioni firewall per configurare le eccezioni appropriate per consentire il traffico in ingresso e in uscita Teredo.

La funzione NotifyStableUnicastIpAddressTable viene usata principalmente dalle applicazioni che usano il client Teredo.

Requisiti

Vedi anche

CancelMibChangeNotify2

GetTeredoPort

NotifyStableUnicastIpAddressTable