IMbnMultiCarrierEvents::OnSetHomeProviderComplete 메서드(mbnapi.h)

중요

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

이 알림 메서드는 SetHomeProvider 작업의 완료를 나타내기 위해 모바일 광대역 서비스에서 호출됩니다.

구문

HRESULT OnSetHomeProviderComplete(
  [in] IMbnMultiCarrier *mbnInterface,
  [in] ULONG            requestID,
  [in] HRESULT          status
);

[in] mbnInterface

모바일 광대역 디바이스 SetHomeProvider 작업을 나타내는 IMbnMultiCarrier 개체입니다.

[in] requestID

모바일 광대역 서비스에서 SetHomeProvider 작업에 할당한 요청 ID입니다.

[in] status

SetHomeProvider의 결과를 나타내는 상태 코드입니다.

값	의미
S_OK	작업이 완료되었습니다.
E_MBN_PROVIDER_NOT_VISIBLE	요청된 공급자가 표시되지 않습니다.
E_INVALIDARG	잘못된 등록 모드 입력, 입력으로 제공된 공급자 ID가 최대 길이 7자보다 길거나 제공된 데이터 클래스가 잘못되었습니다. 입력에 잘못된 인수가 제공되면 모바일 광대역 서비스는 디바이스에 요청을 보내지 않습니다. 수동 등록 모드에서는 요청된 공급자가 사용할 수 없음을 나타냅니다.
E_FAIL	작업을 완료할 수 없습니다. 자세한 내용은 네트워크 오류 코드에서 확인할 수 있습니다.
HRESULT_FROM_WIN32(ERROR_NOT_SUPPORTED)	작업은 디바이스에서 지원되지 않습니다. 다중 통신 사업자를 지원하지 않는 디바이스에서 반환될 수 있습니다.

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

상태S_OK 경우 인터페이스의 홈 공급자가 SetHomeProvider에 의해 새 공급자로 성공적으로 설정되었습니다. 그렇지 않으면 원래 홈 공급자가 변경되지 않고 인터페이스의 연결, 패킷 서비스 등과 같은 이전 상태는 변경되지 않은 상태로 유지됩니다.