IMbnPinEvents：：OnDisableComplete 方法 (mbnapi.h)

  • 發行項

重要

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

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

語法

HRESULT OnDisableComplete(
  [in] IMbnPin      *pin,
  [in] MBN_PIN_INFO *pinInfo,
  [in] ULONG        requestID,
  [in] HRESULT      status
);

參數

[in] pin

PIN 類型的 IMbnPin 介面。

[in] pinInfo

如果發生失敗作業，則為包含剩餘嘗試資訊的 MBN_PIN_INFO 結構的指標。 只有在狀態為E_MBN_FAILURE時，pinInfo的內容才有意義。

[in] requestID

行動寬頻服務所設定的要求識別碼，用來識別 PIN 停用要求。

[in] status

表示作業結果的狀態碼。

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

值 意義
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_FAILURE
 嘗試使用 PIN 失敗。

傳回值

這個方法必須 傳回S_OK。

備註

行動寬頻服務會呼叫OnDisableComplete方法，以報告IMbnPin的Disable方法所初始化之 PIN 停用作業的完成狀態。

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

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

需求

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

另請參閱

IMbnPinEvents