다음을 통해 공유

NotifyNetworkConnectivityHintChange 함수(netioapi.h)

  • 아티클

집계 네트워크 연결 수준 및 비용 힌트가 변경될 때 호출할 애플리케이션 정의 콜백 함수를 등록합니다.

구문

IPHLPAPI_DLL_LINKAGE _NETIOAPI_SUCCESS_ NETIOAPI_API NotifyNetworkConnectivityHintChange(
  [in]  PNETWORK_CONNECTIVITY_HINT_CHANGE_CALLBACK Callback,
  [in]  PVOID                                      CallerContext,
  [in]  BOOLEAN                                    InitialNotification,
  [out] PHANDLE                                    NotificationHandle
);

매개 변수

[in] Callback

애플리케이션 정의 콜백 함수를 가리키는 PNETWORK_CONNECTIVITY_HINT_CHANGE_CALLBACK 형식의 함수 포인터입니다. 콜백 함수는 네트워크 연결 수준 또는 비용 변경이 발생할 때 호출됩니다.

[in] CallerContext

사용자별 호출자 컨텍스트입니다. 이 컨텍스트는 콜백 함수에 제공됩니다.

[in] InitialNotification

True 초기화 알림을 제공해야 하면 이고, 그렇지 않으면 false입니다.

[out] NotificationHandle

HANDLE에 대한 포인터입니다. 함수는 값을 알림 등록에 대한 핸들로 설정합니다.

반환 값

함수가 성공하면 반환 값이 NO_ERROR. 그렇지 않으면 오류 코드가 반환됩니다.

설명

변경 알림을 등록 취소하려면 CancelMibChangeNotify2 함수를 호출하여 NotifyNetworkConnectivityHintChange에서 반환된 NotificationHandle 매개 변수를 전달합니다.

요구 사항

요구 사항 값
지원되는 최소 클라이언트 Windows 10 버전 2004(10.0; 빌드 19041)
지원되는 최소 서버 Windows Server 버전 2004(10.0; 빌드 19041)
대상 플랫폼 Windows
헤더 netioapi.h(Iphlpapi.h 포함)
라이브러리 Iphlpapi.lib
DLL Iphlpapi.dll

추가 정보