InitializeIpInterfaceEntry, funkcja

Funkcja InitializeIpInterfaceEntry inicjuje elementy członkowskie wpisu struktury MIB_IPINTERFACE_ROW z wartościami domyślnymi.

Składnia

VOID NETIOAPI_API_ InitializeIpInterfaceEntry(
  _Inout_ PMIB_IPINTERFACE_ROW Row
);

Parametry

• row [in, out]
  Wskaźnik do struktury MIB_IPINTERFACE_ROW do zainicjowania. Po pomyślnym powrocie pola w tym parametrze są inicjowane z domyślnymi informacjami dotyczącymi interfejsu na komputerze lokalnym.

Wartość zwracana

InitializeIpInterfaceEntry zwraca STATUS_SUCCESS, jeśli funkcja powiedzie się.

Jeśli funkcja nie powiedzie się, InitializeIpInterfaceEntry zwraca jeden z następujących kodów błędów:

Kod powrotny	Opis
STATUS_INVALID_PARAMETER	Do funkcji przekazano nieprawidłowy parametr. Ten błąd jest zwracany, jeśli wskaźnik null jest przekazywany w parametrze wiersza
inne	Użyj funkcji FormatMessage, aby uzyskać ciąg komunikatu dla zwróconego błędu.

Uwagi

W danych wyjściowych elementy członkowskie struktury MIB_IPINTERFACE_ROW, do których wskazuje parametr wiersza, są inicjowane w następujący sposób.

• rodziny
  Ustaw wartość AF_UNSPEC.

• InterfaceLuid
  Ustaw na nieokreśloną wartość.

• Wszyscy inni członkowie
  Ustaw wartość zero.

Sterownik musi użyć funkcji InitializeIpInterfaceEntry, aby zainicjować pola wpisu struktury MIB_IPINTERFACE_ROW z wartościami domyślnymi. Sterownik może następnie zmienić pola we wpisie MIB_IPINTERFACE_ROW, który chce zmodyfikować, a następnie wywołać funkcję SetIpInterfaceEntry.

Wymagania

Platforma docelowa	universal
Wersja	Dostępne w systemie Windows Vista i nowszych wersjach systemów operacyjnych Windows.
Nagłówek	Netioapi.h (include Netioapi.h)
Biblioteka	Netio.lib
IRQL	< DISPATCH_LEVEL

Zobacz też

GetIpInterfaceEntry

GetIpInterfaceTable

MIB_IPINTERFACE_ROW

MIB_IPINTERFACE_TABLE

SetIpInterfaceEntry