無法啟用的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 |