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

重要

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

デバイスの SMS 状態を取得します。

構文

HRESULT GetSmsStatus(
  [out] MBN_SMS_STATUS_INFO *smsStatusInfo
);

パラメーター

[out] smsStatusInfo

デバイスの状態情報を含む MBN_SMS_STATUS_INFO 構造体へのポインター。

戻り値

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

リターン コード	説明
S_OK	メソッドは正常に完了しました。
E_PENDING	SMS の状態は使用できません。 モバイル ブロードバンド サービスは、デバイスの情報をプローブしています。 呼び出し元のアプリケーションは、IMbnSmsEvents インターフェイスの OnSmsStatusChange メソッドに登録することで、SMS の状態が使用可能になったときに通知を受け取ることができます。
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などの回復可能なエラーの場合、モバイル ブロードバンド サービスは、エラー状態が終わったら、この情報についてデバイスに再度クエリを実行します。 たとえば、デバイスがこの情報を取得するために PIN を入力する必要がある場合は、 E_MBN_PIN_REQUIREDを返します。 アプリケーションが PIN を入力してデバイスのロックを解除すると、モバイル ブロードバンド サービスはデバイスからこの情報を取得しようとします。 モバイル ブロードバンド サービスは、IMbnSmsEvents インターフェイスの OnSmsStatusChange メソッドを呼び出します

SMS メッセージ ストアの状態は、システムによって受信された新しいメッセージが原因で変更される可能性があります。 メッセージ ストアの状態が変更されると、モバイル ブロードバンド サービスは IMbnSmsEvent インターフェイスの OnSmsStatusChange メソッドを呼び出します。

メッセージの読み取りまたは削除などのアプリケーションによって発行された操作は、MBN_SMS_STATUS_INFO構造体のフラグをリセットする可能性があります。 このリセットによって SMS ストアが変更された場合、通知メソッドが呼び出されることはありません。

要件

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

関連項目

IMbnSms