IMbnPinManager::GetPinList メソッド (mbnapi.h)
重要
バージョン 1803 Windows 10以降、このセクションで説明する Win32 API は、Windows.Networking.Connectivity 名前空間のWindows ランタイム API に置き換えられます。
デバイスでサポートされているさまざまな PIN の種類の一覧を取得します。
構文
HRESULT GetPinList(
[out, retval] SAFEARRAY **pinList
);
パラメーター
[out, retval] pinList
デバイスでサポートされている PIN の種類を表す MBN_PIN_TYPE 値の一覧へのポインター。 GetPinList がS_OK以外のものを返す場合、pinList は NULL です。それ以外の場合、呼び出し元のアプリケーションは SafeArrayDestroy を呼び出して割り当てられたメモリを解放する必要があります。
戻り値
このメソッドは、これらの値のいずれかを返すことができます。
リターン コード | 説明 |
---|---|
|
メソッドは正常に完了しました。 |
|
PIN の種類は使用できません。 モバイル ブロードバンド サービスは現在、デバイスをプローブして情報を取得しています。 PIN の種類が使用可能な場合、モバイル ブロードバンド サービスは IMbnPinManagerEvents の OnPinListAvailable メソッドを呼び出します。 |
|
デバイスでは、この操作のために PIN を入力する必要があります。 |
|
SIM は挿入されません。 |
|
デバイスに不適切な SIM が挿入されます。 |
注釈
回復可能なエラー E_MBN_PIN_REQUIRED、 E_MBN_SIM_NOT_INSERTED、 およびE_MBN_BAD_SIMでは、モバイル ブロードバンド サービスは、エラー状態が終わると、デバイスからこの情報の取得を試みます。 この情報を取得している間、 GetPinList 呼び出しは E_PENDINGを返します。 取得操作が完了すると、モバイル ブロードバンド サービスは IMbnPinManagerEvents の OnPinListAvailable メソッドを呼び出します。
要件
要件 | 値 |
---|---|
サポートされている最小のクライアント | Windows 7 [デスクトップ アプリ |UWP アプリ] |
サポートされている最小のサーバー | サポートなし |
対象プラットフォーム | Windows |
ヘッダー | mbnapi.h |