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

發行項
03/05/2024

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