IMbnPinManager::GetPinState 메서드(mbnapi.h)

디바이스의 현재 PIN 상태를 가져옵니다.

구문

HRESULT GetPinState(
  [out] ULONG *requestID
);

매개 변수

[out] requestID

이 비동기 요청에 대해 모바일 광대역 서비스에서 설정한 요청 ID에 대한 포인터입니다. 응답에는 동일한 요청 ID가 포함됩니다.

반환 값

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

설명

GetPinState 메서드는 디바이스의 PIN 상태에 대한 비동기 요청을 시작합니다. PIN 상태는 요청된 작업을 완료하기 위해 PIN을 입력해야 하는지를 나타냅니다. 또한 디바이스에서 예상되는 PIN 유형에 대한 정보를 포함하며 선택적으로 유효한 PIN을 입력하기 위해 남은 시도 횟수를 제공합니다.

이 메서드는 항상 디바이스의 현재 PIN 상태를 반환합니다. 이 개체를 만들 때 PIN 상태를 캐시하지 않습니다. 대신 항상 디바이스에 연결하고 디바이스의 현재 PIN 상태를 반환합니다.

비동기 작업이므로 GetPinState 는 즉시 반환됩니다. 작업이 완료되면 모바일 광대역 서비스는 IMbnPinManagerEvents의 OnGetPinStateComplete 메서드를 호출합니다.

작업이 E_MBN_PIN_REQUIRED 반환하거나 디바이스에서 보고한 준비 상태가 MBN_READY_STATE_DEVICE_LOCKED 때마다 애플리케이션은 이 메서드를 사용하여 디바이스 또는 SIM의 잠금을 해제하는 데 필요한 PIN 유형을 쿼리해야 합니다.

이 작업이 진행되는 동안 모바일 광대역 디바이스가 시스템에서 제거되면 IMbnPinManagerEvents의 OnGetPinStateComplete 메서드에 대한 호출이 보장되지 않습니다.

요구 사항

참고 항목

IMbnPinManager