다음을 통해 공유


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

추가 정보

CloseHandle

EnableRouter

IP 도우미 함수 참조

IP 도우미 시작 페이지

OVERLAPPED