FlushIpNetTable 関数 (iphlpapi.h)

  • [アーティクル]

FlushIpNetTable 関数は、指定したインターフェイスのすべての ARP エントリをローカル コンピューターの ARP テーブルから削除します。

構文

IPHLPAPI_DLL_LINKAGE DWORD FlushIpNetTable(
  [in] DWORD dwIfIndex
);

パラメーター

[in] dwIfIndex

すべての ARP エントリを削除するインターフェイスのインデックス。

戻り値

関数が成功した場合、 関数は NO_ERROR (ゼロ) を返します。

関数が失敗した場合、戻り値は次のいずれかのエラー コードになります。

リターン コード 説明
ERROR_ACCESS_DENIED
 アクセスが拒否されました。 このエラーは、Windows Vista および Windows Server 2008 で、次のようないくつかの条件で返されます。ユーザーがローカル コンピューターに必要な管理特権を持っていないか、アプリケーションが組み込みの管理者 (RunAs 管理者) として拡張シェルで実行されていません。
ERROR_INVALID_PARAMETER
 入力パラメーターが無効です。アクションは実行されませんでした。 dwIfIndex パラメーターが無効な場合、このエラーが返されます。
ERROR_NOT_SUPPORTED
 IPv4 トランスポートがローカル コンピューターで構成されていません。
その他
 FormatMessage を使用して、返されたエラーのメッセージ文字列を取得します。

解説

ARP テーブルを取得するには、 GetIpNetTable 関数を呼び出します。

Windows Vista 以降では、 FlushIpNetTable 関数は、Administrators グループのメンバーとしてログオンしているユーザーのみが呼び出すことができます。 Administrators グループのメンバーではないユーザーによって FlushIpNetTable が呼び出された場合、関数呼び出しは失敗し、 ERROR_ACCESS_DENIED が返されます。 この関数は、Windows Vista 以降のユーザー アカウント制御 (UAC) が原因で失敗する場合もあります。 この関数を含むアプリケーションが、組み込みの Administrator 以外の Administrators グループのメンバーとしてログオンしているユーザーによって実行された場合、 requestedExecutionLevel が requireAdministrator に設定されたマニフェスト ファイルでアプリケーションがマークされていない限り、この呼び出しは失敗します。 Windows Vista 以降のアプリケーションにこのマニフェスト ファイルがない場合、組み込みの管理者以外の Administrators グループのメンバーとしてログオンしているユーザーは、この関数を成功させるために、組み込みの管理者 (RunAs 管理者) として拡張シェルでアプリケーションを実行する必要があります。

メモ この関数は、特権操作を実行します。 この関数を正常に実行するには、呼び出し元が Administrators グループまたは NetworkConfigurationOperators グループのメンバーとしてログオンしている必要があります。
 

要件

   
サポートされている最小のクライアント Windows 2000 Professional [デスクトップ アプリのみ]
サポートされている最小のサーバー Windows 2000 Server [デスクトップ アプリのみ]
対象プラットフォーム Windows
ヘッダー iphlpapi.h
Library Iphlpapi.lib
[DLL] Iphlpapi.dll

関連項目

CreateIpNetEntry

DeleteIpNetEntry

GetIfTable

GetIpNetTable

IP ヘルパー関数リファレンス

IP ヘルパーの開始ページ