IMbnPinEvents：：OnChangeComplete 方法 (mbnapi.h)

  • 發行項

重要

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

行動寬頻服務所呼叫的通知方法，表示 PIN 變更作業已完成。

語法

HRESULT OnChangeComplete(
  [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 變更要求。

[in] status

狀態碼，指出 PIN 變更作業的結果。

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

值 意義
S_OK
 作業成功。
HRESULT_FROM_WIN32 (ERROR_NOT_SUPPORTED)
裝置不支援這項作業。
E_FAIL
 無法完成作業。
E_MBN_PIN_REQUIRED
 作業需要 PIN 才能完成。 呼叫的應用程式可以呼叫IMbnPinManager的GetPinState方法，以探索預期的 PIN 類型。
E_MBN_SIM_NOT_INSERTED
 裝置中沒有 SIM 卡。
E_MBN_BAD_SIM
 裝置中有不正確的 SIM 卡。
E_MBN_PIN_DISABLED
 停用的 PIN 不支援 PIN 變更作業。

傳回值

這個方法必須傳回 S_OK。

備註

行動寬頻服務會呼叫OnChangeComplete方法，以報告IMbnPin之Change方法所初始化之 PIN 變更作業的完成狀態。

pinInfo的內容只有在狀態為E_MBN_FAILURE時才有意義。 應該忽略 pinState成員，而且 pinType欄位會設定為目前IMbnPin介面的 PIN 類型。 此結構包含剩餘嘗試輸入有效的 PIN。

例如，如果傳遞以變更 PIN 類型的 PIN 不正確，則作業將會失敗，且狀態碼為 E_MBN_FAILURE。 在此情況下， pinInfo.attemptsRemaining 會指定剩餘嘗試重試此作業的次數。 如果重複嘗試使用錯誤的 PIN 會導致attemptsRemaining變成 0，則應用程式可以呼叫IMbnPinManager的GetPinState方法，以取得所需的 PIN 類型。

需求

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

另請參閱

IMbnPinEvents