NotifyTeredoPortChange függvény

A NotifyTeredoPortChange függvény regisztrálja az illesztőprogramot, hogy értesítést kapjon az UDP-port számának módosításáról, amelyet a Teredo-ügyfél a helyi számítógépen a Teredo szolgáltatásportjához használ.

Szintaxis

NETIOAPI_API NotifyTeredoPortChange(
  _In_    PTEREDO_PORT_CHANGE_CALLBACK Callback,
  _In_    PVOID                        CallerContext,
  _In_    BOOLEAN                      InitialNotification,
  _Inout_ HANDLE *                     NotificationHandle
);

Paraméterek

• visszahívási [in]
  A Függvényre mutató mutató, amely a Teredo-ügyfélportok módosításakor hívható meg. Ez a függvény akkor lesz meghívva, amikor a Rendszer teredói portmódosítási értesítést kap.

• CallerContext [in]
  Olyan felhasználói környezet, amely a Visszahívás paraméterben megadott visszahívási függvénynek ad át egy Teredo-portmódosítási értesítés érkezésekor.

• InitialNotification [in]
  Az az érték, amely azt jelzi, hogy a visszahívást azonnal le kell-e hívni az illesztőprogram-módosítási értesítés regisztrációjának befejeződése után. Ez a kezdeti értesítés nem jelzi, hogy változás történt a Teredo ügyfélportban. Ez a paraméter megerősíti, hogy a visszahívás regisztrálva van.

• NotificationHandle [be, ki]
  Egy mutató, amely egy olyan fogópont visszaadására szolgál, amellyel az illesztőprogram később törölheti az illesztőprogram változásértesítését. Sikeresség esetén a paraméter egy értesítési leírót ad vissza. Ha hiba történik, NULL ad vissza.

Visszaadott érték

NotifyTeredoPortChange a függvény sikeres működése esetén STATUS_SUCCESS ad vissza.

Ha a függvény meghiúsul, NotifyTeredoPortChange a következő hibakódok egyikét adja vissza:

Kód visszaadása	Leírás
ERROR_INVALID_HANDLE	Belső hiba történt, amikor érvénytelen leírót észleltek.
STATUS_INVALID_PARAMETER	Érvénytelen paraméter lett átadva a függvénynek. Ez a hiba akkor jelenik meg, ha a Visszahívási paraméter egy NULL mutató.
STATUS_NOT_ENOUGH_MEMORY	Nem volt elég memória.
Egyéb	A FormatMessage függvénnyel szerezze be a visszaadott hiba üzenetsztringét.

Megjegyzések

A Visszahívás paraméterben megadott visszahívási függvény meghívása szerializálva van. A visszahívási függvényt VOIDtípusú függvényként kell definiálni. A visszahívási függvénynek átadott paraméterek a következők.

Paraméter	Leírás
IN PVOID CallerContext	A CallerContext paraméter, amelyet a rendszer a NotifyTeredoPortChange függvénynek ad át, amikor regisztrálja az illesztőprogramot a változásértesítésekhez.
IN USHORT Port	A Teredo-ügyfél által jelenleg használt UDP-portszám. Ez a paraméter nulla, ha az NotificationType paraméterben a visszahívási függvénynek átadott MIB_NOTIFICATION_TYPE érték MibInitialNotificationértékre van állítva. Ez a helyzet csak akkor fordulhat elő, ha az NotifyTeredoPortChangeInitialNotification paramétere IGAZ értékre van állítva az illesztőprogram változásértesítések regisztrálásakor.
IN MIB_NOTIFICATION_TYPE NotificationType	Az értesítés típusa. Ez a tag lehet az MIB_NOTIFICATION_TYPE enumerálási típus egyik értéke.

Az illesztőprogram a GetTeredoPort függvénnyel lekérheti a Teredo szolgáltatásporthoz használt kezdeti UDP-portszámot.

A Teredo-port dinamikus, és bármikor megváltozhat, amikor a Teredo-ügyfél újraindul a helyi számítógépen. Az illesztőprogramok a NotifyTeredoPortChange függvény meghívásával regisztrálhatnak, hogy értesítést kapnak a Teredo szolgáltatásport változásairól.

A Teredo-ügyfél a 3544-as statikus UDP-portot is használja az RFC 4380-ban meghatározott csoportos küldésű IPv4-cím 224.0.0.253-as címére küldött csoportos küldésű forgalom figyeléséhez. További információ: Teredo: Az IPv6 bújtatása UDPthrough hálózati címfordítások (NAT-k).

A NotifyTeredoPortChange függvényt elsősorban a tűzfalillesztők használják a bejövő és kimenő Teredo-forgalom engedélyezéséhez szükséges kivételek konfigurálására.

Az illesztőprogram változásértesítések törléséhez hívja meg a CancelMibChangeNotify2 függvényt, és adja át a NotificationHandle paramétert, amelyet a NotifyTeredoPortChange függvény ad vissza.

Követelmények

Célplatform	Univerzális
Verzió	Elérhető a Windows Vista és a Windows operációs rendszerek újabb verzióiban.
Fejléc	Netioapi.h (netioapi.h)
Könyvtár	Netio.lib
IRQL	< DISPATCH_LEVEL

Lásd még:

CancelMibChangeNotify2

GetTeredoPort

NotifyStableUnicastIpAddressTable