次の方法で共有

GetIpNetEntry2 関数

  • [アーティクル]

GetIpNetEntry2 関数は、ローカル コンピューター上の近隣 IP アドレス エントリの情報を取得します。

構文

NETIOAPI_API GetIpNetEntry2(
  _Inout_ PMIB_IPNET_ROW2 Row
);

パラメーター

  • 行 [入力、出力]
    近隣 IP アドレス エントリの MIB_IPNET_ROW2 構造体エントリへのポインター。 正常に返されると、この構造体は近隣 IP アドレスのプロパティで更新されます。

戻り値

GetIpNetEntry2 は、関数が成功した場合にSTATUS_SUCCESSを返します。

関数が失敗した場合、GetIpNetEntry2 次のいずれかのエラー コードが返されます。

リターン コード 形容
STATUS_INVALID_PARAMETER

無効なパラメーターが関数に渡されました。 このエラーは、NULL ポインターが Row パラメーターで渡された場合に返されます。 Address、Row パラメーターが指す MIB_IPNET_ROW2 構造体のメンバーが有効な近隣 IPv4 アドレスまたは IPv6 アドレスに設定されていないか、InterfaceLuid と InterfaceIndex メンバーの両方 MIB_IPNET_ROW2が指定されていませんでした。
STATUS_NOT_FOUND

指定されたインターフェイスが見つかりませんでした。 このエラーは、Row パラメーターが指すMIB_IPNET_ROW2構造体の InterfaceLuid または InterfaceIndex メンバーによって指定されたネットワーク インターフェイスが見つからない場合に返されます。
STATUS_NOT_SUPPORTED

要求はサポートされていません。 このエラーは、ローカル コンピューターに IPv4 スタックがなく、行 パラメーターが指すMIB_IPNET_ROW2構造体の Address メンバーに IPv4 アドレスが指定されている場合、またはローカル コンピューターに IPv6 スタックがなく、Address メンバーに IPv6 アドレスが指定されている場合に返されます。
その他の

FormatMessage 関数を使用して、返されたエラーのメッセージ文字列を取得します。

備考

GetIpNetEntry2 関数は、MIB_IPNET_ROW2 構造体エントリを取得するために使用されます。

入力時に、ドライバーは、Row パラメーターが指すMIB_IPNET_ROW2構造体の次のメンバーを初期化する必要があります。

  • アドレス
    有効な近隣 IPv4 または IPv6 アドレスとファミリに設定します。

  • InterfaceLuid または InterfaceIndex の を する
    これらのメンバーは、前に示した順序で使用されます。 そのため、InterfaceLuid 指定した場合、このメンバーを使用してインターフェイスが決定されます。 InterfaceLuid メンバーに値が設定されていない場合 (このメンバーの値が 0 に設定されました)、インターフェイスを決定するために、InterfaceIndex メンバーが次に使用されます。

出力時に、呼び出 しが成功すると、GetIpNetEntry2 は近隣 IP アドレスの他のプロパティを取得し、Row パラメーターが指すMIB_IPNET_ROW2構造を入力します。

ドライバーは、GetIpNetTable2 関数を呼び出して、ローカル コンピューター上の近隣 IP アドレス エントリを列挙できます。

必要条件

ターゲット プラットフォーム

 ユニバーサル

バージョン

Windows Vista 以降のバージョンの Windows オペレーティング システムで使用できます。

ヘッダ

 Netioapi.h (Netioapi.h を含む)

図書館

 Netio.lib

IRQL

< DISPATCH_LEVEL

関連項目

GetIpNetTable2の

MIB_IPNET_ROW2