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 を呼び出して割り当てられたメモリを解放する必要があります。

戻り値

このメソッドは、これらの値のいずれかを返すことができます。

リターン コード 説明
S_OK
 メソッドは正常に完了しました。
E_PENDING
 PIN の種類は使用できません。 モバイル ブロードバンド サービスは現在、デバイスをプローブして情報を取得しています。 PIN の種類が使用可能な場合、モバイル ブロードバンド サービスは IMbnPinManagerEvents の OnPinListAvailable メソッドを呼び出します。
E_MBN_PIN_REQUIRED
 デバイスでは、この操作のために PIN を入力する必要があります。
E_MBN_SIM_NOT_INSERTED
 SIM は挿入されません。
E_MBN_BAD_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

こちらもご覧ください

IMbnPinManager