IMbnPinManagerEvents：：OnGetPinStateComplete 方法 (mbnapi.h)

行動寬頻服務所呼叫的通知方法，表示呼叫IMbnPinManager的GetPinState方法所觸發的非同步作業完成。

語法

HRESULT OnGetPinStateComplete(
  [in] IMbnPinManager *pinManager,
  [in] MBN_PIN_INFO   pinInfo,
  [in] ULONG          requestID,
  [in] HRESULT        status
);

參數

[in] pinManager

IMbnPinManager介面的指標，代表執行作業的行動寬頻裝置。

[in] pinInfo

包含裝置 PIN 資訊的 MBN_PIN_INFO 結構。

如果 pinInfo.pinState 設定為 MBN_PIN_STATE_NONE 則裝置不會輸入任何 PIN。

如果 pinInfo.pinState 設定為 MBN_PIN_STATE_ENTER ，則裝置預期輸入 PIN， 而 pinInfo.pinType 代表裝置預期的 PIN 類型。

如果 pinInfo.pinState 設定為 MBN_PIN_STATE_UNBLOCK 則裝置會封鎖 PIN，而且應該嘗試解除封鎖 PIN 解除封鎖作業。 在此情況下， pinInfo.pinType 代表應該執行解除封鎖作業的 PIN 類型。

如果 pinInfo.pinState 設定為 MBN_PIN_STATE_ENTER 或 MBN_PIN_STATE_UNBLOCK， 則 pinInfo.attemptsRemaining 會包含剩餘嘗試輸入有效 PIN 或 PIN 解除封鎖金鑰 (PUK) 。 如果剩餘的嘗試次數未知， 則 pinInfo.attemptsRemaining 會設定為 MBN_ATTEMPTS_REMAINING_UNKNOWN。

[in] requestID

行動寬頻服務指派的要求識別碼，以識別此作業。

[in] status

作業完成狀態。

呼叫的應用程式可以預期下列其中一個值。

傳回值

這個方法必須傳回 S_OK。

備註

行動寬頻服務會呼叫這個方法，以通知應用程式完成IMbnPinManager的GetPinState方法所觸發的非同步作業。
成功完成時， pinInfo 包含裝置下一個預期 PIN 的相關資訊。

需求

另請參閱

IMbnPinManagerEvents