IMbnSms::GetSmsConfiguration メソッド (mbnapi.h)

重要

バージョン 1803 Windows 10以降、このセクションで説明する Win32 API は、Windows.Networking.Connectivity 名前空間のWindows 运行时 API に置き換えられます。

デバイスの SMS 構成を取得します。

構文

HRESULT GetSmsConfiguration(
  [out, retval] IMbnSmsConfiguration **smsConfiguration
);

パラメーター

[out, retval] smsConfiguration

デバイスの SMS 構成を表す IMbnSmsConfiguration インターフェイス。

戻り値

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

リターン コード	説明
S_OK	メソッドは正常に完了しました。
E_PENDING	SMS 構成は使用できません。 モバイル ブロードバンド サービスは、デバイスの情報をプローブしています。 呼び出し元のアプリケーションは、IMbnSmsEvents インターフェイスの OnSmsConfigurationChange メソッドに登録することで、SMS 構成が使用可能になったときに通知できます。
E_MBN_PIN_REQUIRED	この情報を取得するには、PIN が必要です。
E_MBN_SIM_NOT_INSERTED	デバイスに SIM はありません。
E_MBN_BAD_SIM	デバイスに不適切な SIM があります。
HRESULT_FROM_WIN32(ERROR_NOT_SUPPORTED)	SMS はデバイスではサポートされていません。

解説

E_MBN_PIN_REQUIRED、E_MBN_SIM_NOT_INSERTED、E_MBN_BAD_SIMなどの回復可能なエラーの場合、モバイル ブロードバンド サービスは、エラー状態が終わったときに、この情報についてデバイスに対して再度クエリを実行します。 たとえば、デバイスでこの情報を取得するために PIN を入力する必要がある場合は、 E_MBN_PIN_REQUIREDが返されます。 アプリケーションが PIN を入力してデバイスのロックを解除すると、モバイル ブロードバンド サービスはデバイスからこの情報を取得しようとします。 モバイル ブロードバンド サービスは、IMbnSmsEvents インターフェイスの OnSmsConfigurationChange メソッドを呼び出します

SMS 構成は、任意のアプリケーションによる変更要求なしで、ネットワークまたはデバイスによって更新できます。 このような場合、モバイル ブロードバンド サービスは、IMbnSmsEvents インターフェイスの OnSmsConfigurationChange メソッドを呼び出すことによって、登録されているすべてのアプリケーションに通知します。

要件

サポートされている最小のクライアント	Windows 7 [デスクトップ アプリのみ]
サポートされている最小のサーバー	サポートなし
対象プラットフォーム	Windows
ヘッダー	mbnapi.h

関連項目

IMbnSms