IMbnInterfaceEvents::OnSetPreferredProvidersComplete 메서드(mbnapi.h)

중요

Windows 10 버전 1803부터 이 섹션에 설명된 Win32 API는 Windows.Networking.Connectivity 네임스페이스의 Windows 런타임 API로 대체됩니다.

이 알림 메서드는 Mobile Broadband 서비스에서 SetPreferredProviders 작업의 완료를 나타내기 위해 호출됩니다.

구문

HRESULT OnSetPreferredProvidersComplete(
  [in] IMbnInterface *newInterface,
  [in] ULONG         requestID,
  [in] HRESULT       status
);

[in] newInterface

이 작업이 수행된 디바이스를 나타내는 IMbnInterface 입니다.

[in] requestID

이 비동기 작업을 위해 모바일 광대역 서비스에서 할당한 요청 ID입니다.

[in] status

작업 완료 상태.

다음 표에서는 이 상태 유효한 값을 나열합니다.

값	의미
S_OK	작업이 완료되었습니다.
E_MBN_PIN_REQUIRED	이 작업을 완료하려면 디바이스에 PIN을 입력해야 합니다.
E_MBN_SIM_NOT_INSERTED	SIM이 삽입되지 않습니다.
E_MBN_BAD_SIM	잘못된 SIM이 디바이스에 삽입됩니다.
HRESULT_FROM_WIN32(ERROR_NOT_SUPPORTED)	디바이스는 이 작업을 지원하지 않습니다.

이 메서드는 S_OK 반환해야 합니다.

작업이 성공적으로 완료되면, 즉 상태 S_OK 경우 애플리케이션은 전달된 IMbnInterface의 GetPreferredProviders 메서드를 호출하여 기본 설정 공급자의 업데이트된 목록을 가져올 수 있습니다.

알림을 위해 등록된 여러 애플리케이션이 있는 경우 등록된 모든 애플리케이션에서 이 메서드가 호출됩니다. 즉, 업데이트 작업을 시작하지 않은 애플리케이션도 알림을 받습니다.

IMbnInterface의 SetPreferredProviders 메서드를 호출하면 기본 공급자 목록이 변경되면 IMbnInterfaceEvents의 OnPreferredProvidersChange 메서드가 호출되지 않습니다.