共用方式為


無法啟用的Router 函式 (iphlpapi.h)

UnenableRouter 函式會遞減參考計數,以追蹤啟用 IPv4 轉送的要求數目。 當此參考計數達到零時, UnenableRouter 會關閉本機電腦上的 IPv4 轉送。

語法

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

參數

pOverlapped

重疊結構的指標。 這個結構應該與 EnableRouter 函式呼叫中使用的結構相同。

[out, optional] lpdwEnableCount

DWORD 變數的選擇性指標。 此變數會接收剩餘的參考數目。

傳回值

如果函式成功,傳回值會NO_ERROR。

如果函式失敗,請使用 FormatMessage 取得傳回錯誤的訊息字串。

備註

UnenableRouter 函式專屬於 IPv4 轉送。 進程對 UnenableRouter 進行的每個呼叫都必須對應至同一個進程對 EnableRouter 的先前呼叫。 系統在 對 UnenableRouter 的不重複呼叫時傳回錯誤。 因此,指定的進程無法遞減追蹤另一個進程啟用IPv4轉送的要求數目的參考計數。 此外,如果指定的進程已啟用 IPv4 轉送,則無法由不同的進程停用。

無法精確地判斷追蹤啟用 IPv4 轉送的要求數目的參考計數,因為可能有其他未完成 的 EnableRouter 要求。 因此 ,針對 lpdwEnableCount 參數傳回的值一律是等於ULONG_MAX/2 的大型計數。

如果呼叫 EnableRouter 的進程終止而不呼叫 UnenableRouter,系統會遞減追蹤要求以啟用 IPv4 轉送的參考計數,就像行程呼叫 UnenableRouter 一樣。

呼叫 UnenableRouter 之後,請使用 CloseHandle 呼叫來關閉 疊結構中事件物件的句柄。

規格需求

需求
最低支援的用戶端 Windows 2000 專業版 [僅限傳統型應用程式]
最低支援的伺服器 Windows 2000 Server [僅限傳統型應用程式]
目標平台 Windows
標頭 iphlpapi.h
程式庫 Iphlpapi.lib
Dll Iphlpapi.dll

另請參閱

CloseHandle

EnableRouter

IP 協助程式函式參考

IP 協助程式起始頁

重疊