CancelMibChangeNotify2 함수(netioapi.h)

아티클
02/29/2024

CancelMibChangeNotify2 함수는 IP 인터페이스 변경, IP 주소 변경, IP 경로 변경, Teredo 포트 변경 및 유니캐스트 IP 주소 테이블이 안정적이고 검색할 수 있는 경우 변경 알림에 대한 등록을 취소합니다.

구문

IPHLPAPI_DLL_LINKAGE NETIOAPI_API CancelMibChangeNotify2(
  [in] HANDLE NotificationHandle
);

매개 변수

[in] NotificationHandle

취소할 알림을 나타내기 위해 알림 등록 또는 검색 함수에서 반환된 핸들입니다.

반환 값

함수가 성공하면 반환 값이 NO_ERROR.

함수가 실패하면 반환 값은 다음 오류 코드 중 하나입니다.

반환 코드	설명
ERROR_INVALID_PARAMETER	잘못된 매개 변수가 함수에 전달되었습니다. NotificationHandle 매개 변수가 NULL 포인터인 경우 이 오류가 반환됩니다.
기타	FormatMessage를 사용하여 반환된 오류에 대한 메시지 문자열을 가져옵니다.

설명

CancelMibChangeNotify2 함수는 Windows Vista 이상에서 정의됩니다.

The
CancelMibChangeNotify2 함수는 로컬 컴퓨터에서 IP 인터페이스 변경, IP 주소 변경, IP 경로 변경 또는 Teredo 포트 변경에 대해 이전에 요청된 변경 알림에 대해 등록을 취소합니다. 이러한 요청은 NotifyIpInterfaceChange, NotifyUnicastIpAddressChange, NotifyRouteChange2 또는 NotifyTeredoPortChange를 호출하여 이루어집니다. The
CancelMibChangeNotify2 함수는 유니캐스트 IP 주소 테이블이 로컬 컴퓨터에서 안정적이며 검색할 수 있을 때 알림을 받도록 이전 요청을 취소합니다. 이 요청은 NotifyStableUnicastIpAddressTable 함수를 호출하여 수행됩니다.

이러한 알림 함수에 반환된 NotificationHandle 매개 변수는 CancelMibChangeNotify2 에 전달되어 알림을 등록 취소하거나 보류 중인 요청을 취소하여 안정적인 유니캐스트 IP 주소 테이블을 검색합니다.

애플리케이션은 현재 동일한 NotificationHandle 매개 변수에 대한 알림 콜백 함수를 실행 중인 스레드의 컨텍스트에서 CancelMibChangeNotify2 함수를 호출할 수 없습니다. 그렇지 않으면 해당 콜백을 실행하는 스레드가 교착 상태가 발생합니다. 따라서 CancelMibChangeNotify2 함수는 알림 콜백 루틴의 일부로 직접 호출되어서는 안 됩니다. 좀 더 일반적인 상황에서 CancelMibChangeNotify2 함수를 실행하는 스레드는 알림 콜백 작업을 실행하는 스레드가 유사한 교착 상태를 초래하기 때문에 대기할 리소스를 소유할 수 없습니다. CancelMibChangeNotify2 함수는 알림 콜백을 수신하는 스레드에 종속성이 없는 다른 스레드에서 호출되어야 합니다.

요구 사항

요구 사항	값
지원되는 최소 클라이언트	Windows Vista [데스크톱 앱 \| UWP 앱]
지원되는 최소 서버	Windows Server 2008 [데스크톱 앱 \| UWP 앱]
대상 플랫폼	Windows
헤더	netioapi.h(Iphlpapi.h 포함)
라이브러리	Iphlpapi.lib
DLL	Iphlpapi.dll