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 전달을 사용하도록 설정한 경우 다른 프로세스에서 IPv4 전달을 사용하지 않도록 설정할 수 없습니다.
다른 미해결 EnableRouter 요청이 있을 수 있으므로 IPv4 전달을 사용하도록 설정하는 요청 수를 추적하는 참조 수를 정확하게 확인할 수 없습니다. 따라서 lpdwEnableCount 매개 변수에 대해 반환되는 값은 항상 ULONG_MAX/2와 같은 큰 수입니다.
EnableRouter를 호출하는 프로세스가 UnenableRouter를 호출하지 않고 종료되면 시스템은 요청을 추적하는 참조 수를 감소하여 프로세스가 UnenableRouter를 호출한 것처럼 IPv4 전달을 사용하도록 설정합니다.
UnenableRouter를 호출한 후 CloseHandle 호출을 사용하여 OVERLAPPED 구조체의 이벤트 개체에 대한 핸들을 닫습니다.
요구 사항
요구 사항 | 값 |
---|---|
지원되는 최소 클라이언트 | Windows 2000 Professional[데스크톱 앱만] |
지원되는 최소 서버 | Windows 2000 Server[데스크톱 앱만] |
대상 플랫폼 | Windows |
헤더 | iphlpapi.h |
라이브러리 | Iphlpapi.lib |
DLL | Iphlpapi.dll |