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
작업의 결과를 나타내는 상태 코드입니다.
호출 애플리케이션은 다음 값 중 하나를 예상할 수 있습니다.
| 값 | 의미 |
|---|---|
|
작업이 완료되었습니다. |
|
디바이스는 이 작업을 지원하지 않습니다. |
|
작업을 완료할 수 없습니다. |
|
작업을 완료하려면 PIN이 필요합니다. 호출 애플리케이션은 IMbnPinManager의 GetPinState 메서드를 호출하여 예상되는 PIN 유형을 검색할 수 있습니다. |
|
디바이스에 SIM이 없습니다. |
|
디바이스에 잘못된 SIM이 있습니다. |
반환 값
이 메서드는 S_OK 반환해야 합니다.
설명
OnUnblockComplete 메서드는 IMbnPin의 Unblock 메서드 호출에 의해 초기화된 PIN 차단 해제 작업의 완료 상태 보고하기 위해 모바일 광대역 서비스에서 호출됩니다.
pinInfo의 내용은 상태 E_MBN_FAILURE 경우에만 의미가 있습니다. pinState 멤버는 무시해야 하며 pinType 필드는 현재 IMbnPin 인터페이스의 PIN 형식으로 설정됩니다. 이 구조체에는 유효한 PIN을 입력하려는 시도가 남아 있습니다.
예를 들어 PIN 유형을 변경하기 위해 전달된 PIN이 올바르지 않으면 E_MBN_FAILURE 상태 코드로 작업이 실패합니다. 이 경우 pinInfo.attemptsRemaining 은 이 작업을 다시 시도하기 위해 남은 시도 횟수를 지정합니다. 잘못된 PIN을 반복적으로 시도하면Remaining이 0이 되는 경우 애플리케이션은 IMbnPinManager의 GetPinState 메서드를 호출하여 필요한 PIN 유형을 가져올 수 있습니다.
디바이스 차단 해제에 실패하고 PUK 차단이 MBN_PIN_TYPE_PIN1 핀인 경우 디바이스의 준비 상태도 MBN_READY_STATE_BAD_SIM 변경됩니다. 호출 애플리케이션은 IMbnInterfaceEvents의 OnReadyStateChange 멤버를 통해 ReadyState 변경에 대한 알림을 받습니다.
요구 사항
| 지원되는 최소 클라이언트 | Windows 7 [데스크톱 앱 | UWP 앱] |
| 지원되는 최소 서버 | 지원되는 버전 없음 |
| 대상 플랫폼 | Windows |
| 헤더 | mbnapi.h |