UnenableRouter 関数 (iphlpapi.h)

UnenableRouter 関数は、IPv4 転送を有効にする要求の数を追跡する参照カウントをデクリメントします。 この参照カウントが 0 に達すると、 UnenableRouter はローカル コンピューターで IPv4 転送をオフにします。

構文

IPHLPAPI_DLL_LINKAGE DWORD UnenableRouter(
                  OVERLAPPED *pOverlapped,
  [out, optional] LPDWORD    lpdwEnableCount
);

パラメーター

pOverlapped

OVERLAPPED 構造体へのポインター。 この構造体は、 EnableRouter 関数の呼び出しで使用される構造体と同じである必要があります。

[out, optional] lpdwEnableCount

DWORD 変数への省略可能なポインター。 この変数は、残りの参照の数を受け取ります。

戻り値

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

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

注釈

UnenableRouter 関数は、IPv4 転送に固有です。 プロセスが UnenableRouter に対して行う各呼び出しは、同じプロセスによる EnableRouter への以前の呼び出しに対応している必要があります。 UnenableRouter への余分な呼び出しでエラーが返されます。 その結果、特定のプロセスでは、別のプロセスの IPv4 転送を有効にするための要求の数を追跡する参照カウントをデクリメントできません。 また、IPv4 転送が特定のプロセスによって有効にされた場合、別のプロセスで無効にすることはできません。

他の未処理の EnableRouter 要求が存在する可能性があるため、IPv4 転送を有効にする要求の数を追跡する参照カウントを正確に特定することはできません。 そのため、 lpdwEnableCount パラメーターに対して返される値は、常に ULONG_MAX/2 と等しい大きなカウントになります。

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

UnenableRouter を呼び出した後、CloseHandle 呼び出しを使用して、OVERLAPPED 構造体のイベント オブジェクトへのハンドルを閉じます。

要件

こちらもご覧ください

CloseHandle

EnableRouter

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

IP ヘルパーの開始ページ

OVERLAPPED