EnableRouter 関数 (iphlpapi.h)

EnableRouter 関数は、ローカル コンピューターで IPv4 転送を有効にします。 EnableRouter では、IPv4 転送を有効にする要求の数を追跡する参照カウントもインクリメントされます。

構文

IPHLPAPI_DLL_LINKAGE DWORD EnableRouter(
  HANDLE     *pHandle,
  OVERLAPPED *pOverlapped
);

パラメーター

pHandle

ハンドルへのポインター。 このパラメーターは現在使用されていません。

pOverlapped

OVERLAPPED 構造体へのポインター。 hEvent メンバーを除き、この構造体のすべてのメンバーを 0 に設定する必要があります。 hEvent メンバーには、有効なイベント オブジェクトへのハンドルが含まれている必要があります。 CreateEvent 関数を使用して、このイベント オブジェクトを作成します。

戻り値

EnableRouter 関数が成功した場合、戻り値はERROR_IO_PENDING。

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

リターン コード	説明
ERROR_INVALID_PARAMETER	いずれかのパラメーターが無効です。 pOverlapped パラメーターが NULL の場合、このエラーが返されます。
その他	FormatMessage を使用して、返されたエラーのメッセージ文字列を取得します。

解説

EnableRouter 関数は、IPv4 転送に固有です。 EnableRouter を呼び出すプロセスが UnenableRouter を呼び出さずに終了した場合、システムは、プロセスが UnenableRouter を呼び出したかのように、IPv4 転送を有効にする要求の数を追跡する参照カウントをデクリメントします。

要件

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

関連項目

CreateEvent

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

IP ヘルパーの開始ページ

OVERLAPPED

UnenableRouter