IMbnRegistrationEvents::OnSetRegisterModeComplete 메서드(mbnapi.h)

중요

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

모바일 광대역 서비스에서 설정된 등록 작업을 완료했음을 나타내기 위해 호출된 알림 방법입니다.

구문

HRESULT OnSetRegisterModeComplete(
  [in] IMbnRegistration *newInterface,
  [in] ULONG            requestID,
  [in] HRESULT          status
);

매개 변수

[in] newInterface

해당 디바이스를 나타내는 IMbnRegistration 인터페이스에 대한 포인터입니다. 처리 애플리케이션은 이 인터페이스를 사용하여 디바이스의 현재 등록 상태를 가져올 수 있습니다.

[in] requestID

설정 등록 작업을 추적하기 위해 모바일 광대역 서비스에서 할당한 요청 ID입니다.

[in] status

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

호출 애플리케이션은 가능한 값 중 하나를 예상할 수 있습니다.

값	의미
S_OK	작업이 완료되었습니다.
HRESULT_FROM_WIN32(ERROR_INVALID_STATE)	활성 네트워크 연결이 이미 있습니다. 이미 설정된 데이터 연결이 있는 경우 등록 모드를 변경할 수 없습니다. 애플리케이션은 먼저 연결을 끊은 다음 등록 모드를 변경해야 합니다. 디바이스가 이미 요청된 모드에 있고 요청된 공급자에 연결된 경우 반환 코드가 S_OK.
HRESULT_FROM_WIN32(ERROR_NOT_SUPPORTED)	디바이스에서 작업을 지원하지 않습니다. 요청된 등록 모드를 지원하지 않는 디바이스에서 이 값을 반환할 수 있습니다. 예를 들어 CDMA 디바이스는 수동 등록 모드로 전환하도록 요청될 때 이 오류를 반환합니다.
E_FAIL	작업을 완료할 수 없습니다. 자세한 내용은 네트워크 오류 코드에서 확인할 수 있습니다.
E_INVALIDARG	잘못된 등록 모드 입력 또는 입력으로 제공된 공급자 ID가 최대 길이 7자보다 길거나 제공된 데이터 클래스가 잘못되었습니다. 입력에 잘못된 인수가 제공되면 모바일 광대역 서비스가 디바이스에 요청을 보내지 않습니다. 수동 등록 모드에서는 요청된 공급자가 사용할 수 없음을 나타냅니다.
E_MBN_PIN_REQUIRED	작업을 완료하려면 PIN이 필요합니다.
E_MBN_SERVICE_NOT_ACTIVATED	네트워크 서비스 구독이 만료되었습니다.
E_MBN_PROVIDER_NOT_VISIBLE	수동 등록 모드로 전환할 때만 발생합니다. 스위치가 성공했지만 요청된 공급자가 표시되지 않습니다. 디바이스가 표시되면 요청된 공급자에 등록됩니다.

반환 값

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

요구 사항

지원되는 최소 클라이언트	Windows 7 [데스크톱 앱 | UWP 앱]
지원되는 최소 서버	지원되는 버전 없음
대상 플랫폼	Windows
헤더	mbnapi.h

참고 항목

IMbnRegistrationEvents