共用方式為

IMbnPinManagerEvents：：OnGetPinStateComplete 方法 (mbnapi.h)

  • 發行項

重要

從 Windows 10 1803 版開始，本節所述的 WIN32 API 會由Windows.Networking.Connectivity命名空間中的 Windows 執行階段 API 取代。

行動寬頻服務所呼叫的通知方法，表示呼叫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
 作業成功。
HRESULT_FROM_WIN32 (ERROR_NOT_SUPPORTED)
裝置不支援 PIN 作業。
E_MBN_SIM_NOT_INSERTED
 作業無法完成，因為 SIM 卡不在裝置中。
E_MBN_BAD_SIM
 作業無法完成，因為裝置中偵測到錯誤的 SIM 卡。

傳回值

這個方法必須傳回 S_OK。

備註

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

需求

   
最低支援的用戶端 Windows 7 [傳統型應用程式 |UWP 應用程式]
最低支援的伺服器 都不支援
目標平台 Windows
標頭 mbnapi.h

另請參閱

IMbnPinManagerEvents