IMbnSmsEvents::OnSmsSendComplete メソッド (mbnapi.h)

重要

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

メッセージ送信操作の完了を示す通知メソッド。

構文

HRESULT OnSmsSendComplete(
  [in] IMbnSms *sms,
  [in] ULONG   requestID,
  [in] HRESULT status
);

[in] sms

操作が完了したモバイルブロードバンドデバイスを表す IMbnSms インターフェイス。

[in] requestID

操作を識別するためにモバイルブロードバンドサービスによって割り当てられた要求 ID。

[in] status

操作の結果を示す状態コード。

呼び出し元のアプリケーションでは、次のいずれかの値が必要です。

値	意味
S_OK	操作に成功しました。
E_MBN_SIM_NOT_INSERTED	デバイスに SIM はありません。
E_MBN_BAD_SIM	デバイスに不適切な SIM があります。
E_MBN_PIN_REQUIRED	操作を完了するには PIN が必要です。
HRESULT_FROM_WIN32(ERROR_NOT_SUPPORTED)	SMS 操作または特定の SMS 形式は、デバイスでサポートされていません。
E_MBN_SMS_MEMORY_FAILURE	SMS メモリエラー。
E_MBN_SMS_UNKNOWN_SMSC_ADDRESS	不明または不完全な SMS サービスセンターアドレス。
E_MBN_SERVICE_NOT_ACTIVATED	デバイスで携帯ネットワークサービスがアクティブ化されていません。
E_INVALIDARG	デバイスが送信要求で無効なパラメーターを検出しました。
E_MBN_SMS_NETWORK_TIMEOUT	ネットワークタイムアウトが発生しました。
E_MBN_NOT_REGISTERED	デバイスはどのネットワークにも登録されていません。
E_MBN_SMS_LANG_NOT_SUPPORTED	CDMA デバイスは言語をサポートしていません。
E_MBN_SMS_ENCODING_NOT_SUPPORTED	CDMA デバイスは、要求されたエンコードをサポートしていません。
E_MBN_SMS_OPERATION_NOT_ALLOWED	要求された SMS 操作は、SIM では許可されません。
E_MBN_SMS_MEMORY_FULL	デバイス/SIM メモリがいっぱいです。

このメソッドは 、S_OKを返す必要があります。

送信操作は、デバイスがネットワークに正常に登録された後にのみ試行する必要があります。