IMbnPinManagerEvents
COM公式ドキュメント
PIN Manager のイベントが発生したことを示すために使用される通知インターフェイスです。
解説(Remarks)
通知を登録する手順は次のとおりです。
- IMbnInterfaceManager オブジェクトで QueryInterface を呼び出して、IConnectionPointContainer インターフェイスを取得します。
- 返されたインターフェイスで FindConnectionPoint を呼び出し、riid に IID_IMbnPinManagerEvents を渡します。
- 返されたコネクションポイントで Advise を呼び出し、IMbnPinManagerEvents を実装するオブジェクトの IUnknown インターフェイスへのポインターを pUnk に渡します。
COM 通知を登録するコードの例については、COM Connection Points の記事の Client セクションを参照してください。
メソッド 2
vtbl = vtable インデックス(0始まり)。HSP等からCOMメソッドをインデックス指定で呼ぶ際に使用します。0〜2 は IUnknown。
デバイスの PIN の一覧が利用可能になったことを示すために、モバイルブロードバンドサービスによって呼び出される通知メソッドです。
| pinManager | IMbnPinManager* | in | PIN の一覧が利用可能なモバイルブロードバンドデバイスを表す IMbnPinManager インターフェイスへのポインターです。 |
戻り値
このメソッドは S_OK を返す必要があります。
解説(Remarks)
このメソッドは、サポートされる PIN の種類の一覧が利用可能になったとき、または PIN 一覧の取得操作でエラーが発生したときに、アプリケーションに通知するためにモバイルブロードバンドサービスによって呼び出されます。呼び出し側のアプリケーションは、渡された IMbnPinManager の GetPinList メソッドを実行することで、サポートされる PIN の利用可能な一覧、または操作で返されたエラーコードを取得できます。
IMbnPinManager の GetPinState メソッドの呼び出しによって開始された非同期操作の完了を示すために、モバイルブロードバンドサービスによって呼び出される通知メソッドです。
| pinManager | IMbnPinManager* | in | 操作が実行されたモバイルブロードバンドデバイスを表す IMbnPinManager インターフェイスへのポインターです。 | ||||||||||
| pinInfo | MBN_PIN_INFO | in | デバイスの 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 に設定されます。 | ||||||||||
| requestID | DWORD | in | この操作を識別するためにモバイルブロードバンドサービスによって割り当てられた要求 ID です。 | ||||||||||
| status | HRESULT | in | 操作の完了ステータスです。 呼び出し側のアプリケーションでは、次のいずれかの値が想定されます。
|
戻り値
このメソッドは S_OK を返す必要があります。
解説(Remarks)
このメソッドは、IMbnPinManager の GetPinState メソッドの呼び出しによって開始された非同期操作の完了をアプリケーションに通知するために、モバイルブロードバンドサービスによって呼び出されます。
正常に完了すると、pinInfo にはデバイスが次に必要とする PIN に関する情報が格納されます。
Microsoft 公式リファレンス: 英語 (en-us) · 日本語 (ja-jp) · 原文ソース (GitHub)
HSP用 COM定義
#usecom / #comfunc によるHSPのCOM呼び出し定義。数字は vtbl インデックス(0始まり)。クラスIDが無い場合 #usecom の末尾は "{}"、ある場合は "{CLSID}"。
#define global IID_IMbnPinManagerEvents "{DCBBBAB6-2006-4BBB-AAEE-338E368AF6FA}"
#usecom global IMbnPinManagerEvents IID_IMbnPinManagerEvents "{}"
#comfunc global IMbnPinManagerEvents_OnPinListAvailable 3 sptr
#comfunc global IMbnPinManagerEvents_OnGetPinStateComplete 4 sptr,int,int,int
; ※数字は vtbl インデックス(0始まり)。0/1/2 は IUnknown(QueryInterface/AddRef/Release)。
; ※このインターフェースは直接 CoCreateInstance するクラスIDが無いため "{}"(他メソッド/アクティベーションで取得)。
; ※ハンドル/void*等の不透明ポインタは IronHSP では intptr 指定が可能。