IMbnPin::Unblock 메서드(mbnapi.h)

중요

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

차단된 PIN의 차단을 해제합니다.

구문

HRESULT Unblock(
  [in]  LPCWSTR puk,
  [in]  LPCWSTR newPin,
  [out] ULONG   *requestID
);

[in] puk

이 PIN 형식의 암호 차단 해제 키(PUK) 값입니다.

[in] newPin

이 PIN 유형에 대해 설정할 새 PIN입니다.

[out] requestID

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

이 메서드는 이러한 값 중 하나를 반환할 수 있습니다.

반환 코드	Description
S_OK	메서드가 완료되었습니다.
HRESULT_FROM_WIN32(ERROR_SERVICE_NOT_ACTIVE)	모바일 광대역 서비스가 이 시스템에서 실행되고 있지 않습니다.
E_HANDLE	잘못된 인터페이스입니다. 모바일 광대역 디바이스가 시스템에서 제거되었을 수 있습니다.
HRESULT_FROM_WIN32(ERROR_NOT_FOUND)	잘못된 인터페이스입니다. 모바일 광대역 디바이스가 시스템에서 제거되었을 가능성이 높습니다.
E_ACCESSDENIED	이 메서드는 프로세스 권한을 호출할 수 없습니다.

차단 해제 메서드는 PUK를 입력하여 핀 유형에 대한 PIN을 차단 해제하고 새 PIN을 설정합니다. 이 IMbnPin의 PinType 속성은 변경되는 PIN 유형을 나타냅니다.

이 작업은 비동기 작업입니다. 메서드가 성공적으로 반환되면 작업이 완료되면 모바일 광대역 서비스에서 IMbnPinEvents의 OnUnblockComplete 메서드를 호출합니다.

IMbnPinManager의 GetPinState 메서드가 현재 PIN 상태가 MBN_PIN_STATE_UNBLOCK 설정된 결과를 얻을 때마다 애플리케이션은 IMbnPinManagerEvents의 OnGetPinStateComplete 메서드에 의해 전달된 PinInfo.pinType에 반환되는 PIN 유형에서 차단 해제를 사용해야 합니다.

이 메서드를 호출하려면 관리자 권한이 필요합니다.