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

重要

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

デバイスの SMS 構成を更新します。

構文

HRESULT SetSmsConfiguration(
  [in]  IMbnSmsConfiguration *smsConfiguration,
  [out] ULONG                *requestID
);

[in] smsConfiguration

デバイスを更新する新しい SMS 構成を表す IMbnSmsConfiguration インターフェイス。

[out] requestID

この要求を識別するためにモバイルブロードバンドサービスによって発行された要求 ID へのポインター。

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

リターンコード	説明
S_OK	メソッドは正常に完了しました。
HRESULT_FROM_WIN32(ERROR_SERVICE_NOT_ACTIVE)	モバイルブロードバンドサービスがシステム上で実行されていません。
E_HANDLE	インターフェイスが無効です。ほとんどの場合、デバイスがシステムから削除されたためです。
HRESULT_FROM_WIN32(ERROR_NOT_FOUND)	インターフェイスが無効です。ほとんどの場合、モバイルブロードバンドデバイスはシステムから削除されています。

アプリケーションでは 、SetSmsConfiguration を使用して、デバイスの既定の SMS Service Center アドレスを変更できます。

アプリケーションは、デバイスの SMS 構成を設定するために次の手順を実行する必要があります。

これは、すぐに返される非同期操作です。メソッドがエラーなしで返された場合、モバイルブロードバンドサービスは IMbnSmsEvents インターフェイスの OnSetSmsConfigurationComplete メソッドを呼び出します。