InitializeIpInterfaceEntry 関数
InitializeIpInterfaceEntry 関数は、MIB_IPINTERFACE_ROW 構造体エントリのメンバーを既定値で初期化します。
構文
VOID NETIOAPI_API_ InitializeIpInterfaceEntry(
_Inout_ PMIB_IPINTERFACE_ROW Row
);
パラメーター
- Row [in, out]
初期化する MIB_IPINTERFACE_ROW 構造へのポインター。 正常に戻った場合、このパラメーターのフィールドは、ローカル コンピューター上のインターフェイスにおける既定の情報で初期化されます。
戻り値
InitializeIpInterfaceEntry は、その関数が成功した場合に STATUS_SUCCESS を返します。
その関数が失敗した場合、InitializeIpInterfaceEntry は次のいずれか 1 つのエラー コードを返します。
| リターン コード | 説明 |
|---|---|
| STATUS_INVALID_PARAMETER | その関数に無効なパラメーターが渡された。 このエラーは、Row パラメーターに NULL ポインターが渡された場合に返されます。 |
| その他 | FormatMessage 関数を使用して、返されたエラーのメッセージ文字列を取得します。 |
解説
出力時に、Row パラメーターが指す MIB_IPINTERFACE_ROW 構造体 のメンバーは、次のように初期化されます。
ファミリ
AF_UNSPEC に設定します。InterfaceLuid
指定されていない値に設定します。その他の全メンバー
0 に設定します。
ドライバーは、InitializeIpInterfaceEntry 関数を使用して、既定値で MIB_IPINTERFACE_ROW 構造体エントリのフィールドを初期化する必要があります。 その後、ドライバーは、修正したい MIB_IPINTERFACE_ROW エントリのフィールドを変更すると、SetIpInterfaceEntry 関数を呼び出すことができます。
要件
対象プラットフォーム |
ユニバーサル |
バージョン |
Windows Vista 以降のバージョンの Windows オペレーティング システムで使用できます。 |
ヘッダー |
Netioapi.h (Netioapi.h を含む) |
ライブラリ |
Netio.lib |
IRQL |
< DISPATCH_LEVEL |