Megjegyzés
Az oldalhoz való hozzáféréshez engedély szükséges. Megpróbálhat bejelentkezni vagy módosítani a címtárat.
Az oldalhoz való hozzáféréshez engedély szükséges. Megpróbálhatja módosítani a címtárat.
A SetUnicastIpAddressEntry függvény beállítja egy meglévő egyedi küldésű IP-cím bejegyzés tulajdonságait egy helyi számítógépen.
Szintaxis
NETIOAPI_API SetUnicastIpAddressEntry(
_In_ const MIB_UNICASTIPADDRESS_ROW *Row
);
Paraméterek
-
sor [in]
Mutató egy meglévő egycímes IP-címbejegyzés MIB_UNICASTIPADDRESS_ROW struktúrabejegyzésére.
Visszaadott érték
SetUnicastIpAddressEntry a függvény sikeres működése esetén STATUS_SUCCESS ad vissza.
Ha a függvény meghiúsul, SetUnicastIpAddressEntry a következő hibakódok egyikét adja vissza:
| Kód visszaadása | Leírás |
|---|---|
| STATUS_INVALID_PARAMETER | Érvénytelen paraméter lett átadva a függvénynek. Ez a hiba akkor jelenik meg, ha egy NULL mutatót ad át a Sor paraméterben, az Cím azon MIB_UNICASTIPADDRESS_ROW struktúra azon tagja, amely szerint a sor paraméterpontjai nem érvényes egycímes IPv4- vagy IPv6-címre voltak beállítva, vagy InterfaceLuid és InterfaceIndex MIB_UNICASTIPADDRESS_ROW-struktúra tagjai nem voltak meghatározva. |
| STATUS_NOT_FOUND | A megadott felület nem található. Ez a hiba akkor jelenik meg, ha a függvény nem találja a InterfaceLuid vagy InterfaceIndex által megadott hálózati adaptert, tagja annak a MIB_UNICASTIPADDRESS_ROW struktúrának, amelyre a Sor paraméter mutat. |
| STATUS_NOT_SUPPORTED | A kérés nem támogatott. Ez a hiba akkor jelenik meg, ha nem található IPv4-verem a helyi számítógépen, és egy IPv4-cím van megadva a Cím azon MIB_UNICASTIPADDRESS_ROW struktúrában, amelyre a Sor paraméter mutat, vagy ha nem található IPv6-verem a helyi számítógépen, és egy IPv6-cím van megadva a Cím tagban. |
| Egyéb | A FormatMessage függvénnyel szerezze be a visszaadott hiba üzenetsztringét. |
Megjegyzések
A GetUnicastIpAddressEntry függvény általában egy meglévő MIB_UNICASTIPADDRESS_ROW módosítandó struktúrabejegyzés lekérésére szolgál. Az illesztő ezután módosíthatja a módosítani kívánt MIB_UNICASTIPADDRESS_ROW bejegyzés tagjait, majd meghívhatja a SetUnicastIpAddressEntry függvényt.
Az illesztő meghívhatja a InitializeUnicastIpAddressEntry függvényt, hogy a módosítások végrehajtása előtt inicializálja egy MIB_UNICASTIPADDRESS_ROW struktúrabejegyzés tagjait alapértelmezett értékekkel. Az illesztő azonban általában a InterfaceLuid vagy InterfaceIndex tagot menti, mielőtt meghívja InitializeUnicastIpAddressEntry, és a hívás után visszaállítja az egyik tagot.
Az illesztőprogramnak inicializálnia kell a MIB_UNICASTIPADDRESS_ROW struktúra alábbi tagjait, amelyekre a sor paraméter mutat.
Cím
Állítsa be érvényes egycímes IPv4- vagy IPv6-címre és -családra.InterfaceLuid vagy InterfaceIndex
Ezeket a tagokat a korábban felsorolt sorrendben használja a rendszer. Ha tehát InterfaceLuid van megadva, ez a tag határozza meg a felületet. Ha a InterfaceLuid taghoz nem állított be értéket (ennek a tagnak az értéke nulla volt), a InterfaceIndex tagot használja a rendszer a felület meghatározásához.
Ha az OnLinkPrefixLength tagja annak a MIB_UNICASTIPADDRESS_ROW struktúrának, amelynek a sor paramétere 255-re van állítva, SetUnicastIpAddressEntry beállítja az egyedi küldésű IP-cím tulajdonságait úgy, hogy az OnLinkPrefixLength tag egyenlő legyen az IP-cím hosszával. Egycímes IPv4-cím esetén OnLinkPrefixLength értéke 32. Egycímes IPv6-cím esetén OnLinkPrefixLength értéke 128. Ha ezek a beállítások egy IPv4-cím helytelen alhálózati maszkját vagy egy IPv6-cím helytelen hivatkozáselőtagját eredményeznék, az illesztőnek a megfelelő értékre kell állítania ezt a tagot, mielőtt meghívná SetUnicastIpAddressEntry.
SetUnicastIpAddressEntry figyelmen kívül hagyja a DadState, ScopeIdés CreationTimeStamp azon MIB_UNICASTIPADDRESS_ROW struktúra azon tagjait, amelyekre a Sor paraméter utal. Ezeket a tagokat a hálózati verem állítja be, és nem módosítható a SetUnicastIpAddressEntry függvénnyel. A ScopeId tagot automatikusan az a felület határozza meg, amelyen a címet hozzáadták.
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 |