IMbnPinEvents

このインターフェイスは、非同期の PIN リクエストが完了したことを通知するために使用される通知インターフェイスです。

通知を登録する手順は次のとおりです。

1. IMbnInterfaceManager オブジェクトに対して QueryInterface を呼び出し、IConnectionPointContainer インターフェイスを取得します。
2. 返されたインターフェイスに対して FindConnectionPoint を呼び出し、riid に IID_IMbnPinEvents を渡します。
3. 返された接続ポイントに対して Advise を呼び出し、IMbnPinEvents を実装するオブジェクト上の IUnknown インターフェイスへのポインターを pUnk に渡します。

COM 通知を登録するコードの例については、COM Connection Points の記事の Client セクションを参照してください。

PIN の有効化操作が完了したことを示すために、モバイルブロードバンドサービスによって呼び出される通知メソッドです。

このメソッドは S_OK を返す必要があります。

OnEnableComplete メソッドは、IMbnPin の Enable メソッドの呼び出しによって開始された PIN 有効化操作の完了ステータスを報告するために、モバイルブロードバンドサービスによって呼び出されます。

pinInfo の内容は、status が E_MBN_FAILURE の場合にのみ意味を持ちます。pinState メンバーは無視する必要があり、pinType フィールドには現在の IMbnPin インターフェイスの PIN の種類が設定されます。この構造体には、有効な PIN を入力するための残り試行回数が格納されます。

たとえば、PIN の種類を変更するために渡された PIN が正しくない場合、操作はステータスコード E_MBN_FAILURE で失敗します。この場合、pinInfo.attemptsRemaining は、この操作を再試行できる残り回数を示します。 誤った PIN での試行を繰り返して attemptsRemaining が 0 になった場合、アプリケーションは IMbnPinManager の GetPinState メソッドを呼び出して、必要な PIN の種類を取得できます。

PIN の無効化操作が完了したことを示すために、モバイルブロードバンドサービスによって呼び出される通知メソッドです。

このメソッドは S_OK を返す必要があります。

OnDisableComplete メソッドは、IMbnPin の Disable メソッドの呼び出しによって開始された PIN 無効化操作の完了ステータスを報告するために、モバイルブロードバンドサービスによって呼び出されます。

pinInfo の内容は、status が E_MBN_FAILURE の場合にのみ意味を持ちます。pinState メンバーは無視する必要があり、pinType フィールドには現在の IMbnPin インターフェイスの PIN の種類が設定されます。この構造体には、有効な PIN を入力するための残り試行回数が格納されます。

たとえば、PIN の種類を変更するために渡された PIN が正しくない場合、操作はステータスコード E_MBN_FAILURE で失敗します。この場合、pinInfo.attemptsRemaining は、この操作を再試行できる残り回数を示します。 誤った PIN での試行を繰り返して attemptsRemaining が 0 になった場合、アプリケーションは IMbnPinManager の GetPinState メソッドを呼び出して、必要な PIN の種類を取得できます。

PIN の入力操作が完了したことを示すために、モバイルブロードバンドサービスによって呼び出される通知メソッドです。

このメソッドは S_OK を返す必要があります。

OnEnterComplete メソッドは、IMbnPin の Enter メソッドの呼び出しによって開始された PIN 入力操作の完了ステータスを報告するために、モバイルブロードバンドサービスによって呼び出されます。

pinInfo の内容は、status が E_MBN_FAILURE の場合にのみ意味を持ちます。pinState メンバーは無視する必要があり、pinType フィールドには現在の IMbnPin インターフェイスの PIN の種類が設定されます。この構造体には、有効な PIN を入力するための残り試行回数が格納されます。

たとえば、PIN の種類を変更するために渡された PIN が正しくない場合、操作はステータスコード E_MBN_FAILURE で失敗します。この場合、pinInfo.attemptsRemaining は、この操作を再試行できる残り回数を示します。 誤った PIN での試行を繰り返して attemptsRemaining が 0 になった場合、アプリケーションは IMbnPinManager の GetPinState メソッドを呼び出して、必要な PIN の種類を取得できます。

PIN の変更操作が完了したことを示すために、モバイルブロードバンドサービスによって呼び出される通知メソッドです。

このメソッドは S_OK を返す必要があります。

OnChangeComplete メソッドは、IMbnPin の Change メソッドの呼び出しによって開始された PIN 変更操作の完了ステータスを報告するために、モバイルブロードバンドサービスによって呼び出されます。

pinInfo の内容は、status が E_MBN_FAILURE の場合にのみ意味を持ちます。pinState メンバーは無視する必要があり、pinType フィールドには現在の IMbnPin インターフェイスの PIN の種類が設定されます。この構造体には、有効な PIN を入力するための残り試行回数が格納されます。

たとえば、PIN の種類を変更するために渡された PIN が正しくない場合、操作はステータスコード E_MBN_FAILURE で失敗します。この場合、pinInfo.attemptsRemaining は、この操作を再試行できる残り回数を示します。 誤った PIN での試行を繰り返して attemptsRemaining が 0 になった場合、アプリケーションは IMbnPinManager の GetPinState メソッドを呼び出して、必要な PIN の種類を取得できます。

PIN のブロック解除操作が完了したことを示すために、モバイルブロードバンドサービスによって呼び出される通知メソッドです。

このメソッドは S_OK を返す必要があります。

OnUnblockComplete メソッドは、IMbnPin の Unblock メソッドの呼び出しによって開始された PIN ブロック解除操作の完了ステータスを報告するために、モバイルブロードバンドサービスによって呼び出されます。

pinInfo の内容は、status が E_MBN_FAILURE の場合にのみ意味を持ちます。pinState メンバーは無視する必要があり、pinType フィールドには現在の IMbnPin インターフェイスの PIN の種類が設定されます。この構造体には、有効な PIN を入力するための残り試行回数が格納されます。

たとえば、PIN の種類を変更するために渡された PIN が正しくない場合、操作はステータスコード E_MBN_FAILURE で失敗します。この場合、pinInfo.attemptsRemaining は、この操作を再試行できる残り回数を示します。 誤った PIN での試行を繰り返して attemptsRemaining が 0 になった場合、アプリケーションは IMbnPinManager の GetPinState メソッドを呼び出して、必要な PIN の種類を取得できます。

デバイスのブロック解除に失敗し、その PUK ブロックが MBN_PIN_TYPE_PIN1 の PIN によるものである場合、デバイスの準備状態も MBN_READY_STATE_BAD_SIM に変化する結果となります。呼び出し元のアプリケーションには、IMbnInterfaceEvents の OnReadyStateChange メンバーを通じて ReadyState の変化が通知されます。