InitializeIpInterfaceEntry-Funktion
Die InitializeIpInterfaceEntry-Funktion initialisiert die Member eines MIB_IPINTERFACE_ROW Struktureintrags mit Standardwerten.
Syntax
VOID NETIOAPI_API_ InitializeIpInterfaceEntry(
_Inout_ PMIB_IPINTERFACE_ROW Row
);
Parameter
- Zeile [ein, aus]
Ein Zeiger auf eine zu initialisierende MIB_IPINTERFACE_ROW Struktur. Bei erfolgreicher Rückgabe werden die Felder in diesem Parameter mit Standardinformationen für eine Schnittstelle auf dem lokalen Computer initialisiert.
Rückgabewert
InitializeIpInterfaceEntry gibt STATUS_SUCCESS zurück, wenn die Funktion erfolgreich ist.
Wenn die Funktion fehlschlägt, gibt InitializeIpInterfaceEntry einen der folgenden Fehlercodes zurück:
| Rückgabecode | Beschreibung |
|---|---|
| STATUS_INVALID_PARAMETER | Es wurde ein ungültiger Parameter an die Funktion übergeben. Dieser Fehler wird zurückgegeben, wenn ein NULL-Zeiger im Row-Parameter übergeben wird. |
| Andere | Verwenden Sie die FormatMessage-Funktion , um die Nachrichtenzeichenfolge für den zurückgegebenen Fehler abzurufen. |
Bemerkungen
Bei der Ausgabe werden die Member der MIB_IPINTERFACE_ROW-Struktur , auf die der Row-Parameter verweist, wie folgt initialisiert.
Familie
Legen Sie auf AF_UNSPEC fest.InterfaceLuid
Legen Sie auf einen nicht angegebenen Wert fest.Alle anderen Mitglieder
Auf NULL festlegen.
Ihr Treiber muss die InitializeIpInterfaceEntry-Funktion verwenden, um die Felder eines MIB_IPINTERFACE_ROW Struktureintrags mit Standardwerten zu initialisieren. Ein Treiber kann dann die Felder im MIB_IPINTERFACE_ROW Eintrag ändern, den er ändern möchte, und dann die SetIpInterfaceEntry-Funktion aufrufen.
Anforderungen
Zielplattform |
Universell |
Version |
Verfügbar in Windows Vista und höheren Versionen der Windows-Betriebssysteme. |
Header |
Netioapi.h (einschließlich Netioapi.h) |
Bibliothek |
Netio.lib |
IRQL |
< DISPATCH_LEVEL |