다음을 통해 공유


IMbnPinEvents::OnUnblockComplete 메서드(mbnapi.h)

중요

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

PIN 차단 해제 작업이 완료되었음을 나타내기 위해 모바일 광대역 서비스에서 호출한 알림 메서드

구문

HRESULT OnUnblockComplete(
  [in] IMbnPin      *Pin,
  [in] MBN_PIN_INFO *pinInfo,
  [in] ULONG        requestID,
  [in] HRESULT      status
);

매개 변수

[in] Pin

PIN 형식을 나타내는 IMbnPin 인터페이스입니다.

[in] pinInfo

오류 작업의 경우 남은 시도에 대한 정보를 포함하는 MBN_PIN_INFO 구조체에 대한 포인터입니다. pinInfo의 내용은 상태 E_MBN_FAILURE 경우에만 의미가 있습니다.

[in] requestID

PIN 차단 해제 요청을 식별하기 위해 모바일 광대역 서비스에서 설정한 요청 ID입니다.

[in] status

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

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

의미
S_OK
작업이 완료되었습니다.
HRESULT_FROM_WIN32(ERROR_NOT_SUPPORTED)
디바이스는 이 작업을 지원하지 않습니다.
E_FAIL
작업을 완료할 수 없습니다.
E_MBN_PIN_REQUIRED
작업을 완료하려면 PIN이 필요합니다. 호출 애플리케이션은 IMbnPinManagerGetPinState 메서드를 호출하여 예상되는 PIN 유형을 검색할 수 있습니다.
E_MBN_SIM_NOT_INSERTED
디바이스에 SIM이 없습니다.
E_MBN_BAD_SIM
디바이스에 잘못된 SIM이 있습니다.

반환 값

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

설명

OnUnblockComplete 메서드는 IMbnPinUnblock 메서드 호출에 의해 초기화된 PIN 차단 해제 작업의 완료 상태 보고하기 위해 모바일 광대역 서비스에서 호출됩니다.

pinInfo의 내용은 상태 E_MBN_FAILURE 경우에만 의미가 있습니다. pinState 멤버는 무시해야 하며 pinType 필드는 현재 IMbnPin 인터페이스의 PIN 형식으로 설정됩니다. 이 구조체에는 유효한 PIN을 입력하려는 시도가 남아 있습니다.

예를 들어 PIN 유형을 변경하기 위해 전달된 PIN이 올바르지 않으면 E_MBN_FAILURE 상태 코드로 작업이 실패합니다. 이 경우 pinInfo.attemptsRemaining 은 이 작업을 다시 시도하기 위해 남은 시도 횟수를 지정합니다. 잘못된 PIN을 반복적으로 시도하면Remaining이 0이 되는 경우 애플리케이션은 IMbnPinManagerGetPinState 메서드를 호출하여 필요한 PIN 유형을 가져올 수 있습니다.

디바이스 차단 해제에 실패하고 PUK 차단이 MBN_PIN_TYPE_PIN1 핀인 경우 디바이스의 준비 상태도 MBN_READY_STATE_BAD_SIM 변경됩니다. 호출 애플리케이션은 IMbnInterfaceEventsOnReadyStateChange 멤버를 통해 ReadyState 변경에 대한 알림을 받습니다.

요구 사항

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

참고 항목

IMbnPinEvents