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

  • [アーティクル]

重要

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

CDMA バイナリ形式でメッセージを送信します。

構文

HRESULT SmsSendCdmaPdu(
  [in]  SAFEARRAY *message,
  [out] ULONG     *requestID
);

パラメーター

[in] message

3GPP2 仕様 C.S0015-A 「ワイドバンド拡散スペクトル システムのショート メッセージ サービス (SMS)」のセクション 3.4.2.1 "SMS ポイントツーポイント メッセージ" に従ってエンコードされた CMDA メッセージを表すバイト配列。 SMS では、ワイヤレス メッセージング Teleservice (WMT) 形式のみがサポートされます。

[out] requestID

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

戻り値

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

リターン コード 説明
S_OK
 メソッドは正常に完了しました。
HRESULT_FROM_WIN32(ERROR_SERVICE_NOT_ACTIVE)
 モバイル ブロードバンド サービスがこのシステムで実行されていません。
E_HANDLE
 インターフェイスは無効です。デバイスがシステムから削除された可能性が高いです。
HRESULT_FROM_WIN32(ERROR_NOT_FOUND)
 インターフェイスが無効です。 ほとんどの場合、モバイル ブロードバンド デバイスがシステムから削除されています。
E_INVALIDARG
 メッセージ が無効です。
HRESULT_FROM_WIN32(ERROR_NOT_SUPPORTED)
 デバイスは、要求された形式での SMS メッセージの送信をサポートしていません。 たとえば、この関数が GSM デバイスに対して呼び出される場合です。

注釈

この方法は、CDMA デバイスにのみ適用されます。

SmsSendCdmaPdu を使用すると、3GPP2 仕様 C.S0015-A の「ワイドバンド 拡散スペクトル システムのショート メッセージ サービス (SMS)」の「SMS ポイントツーポイント メッセージ」のセクション 3.4.2.1 に従ってエンコードされたバイナリ形式の SMS メッセージを送信できます。 SMS では、ワイヤレス メッセージング Teleservice (WMT) 形式のみがサポートされます。

SmsSendCdmaPdu は、CDMA デバイスがバイナリ形式の SMS の送信をサポートしている場合にのみ呼び出す必要があります。 デバイスは、MBN_INTERFACE_CAPSで MBN_SMS_PDU_SENDを設定することで、この形式を報告します。

これは非同期操作であり、メソッド呼び出しはすぐに返されます。 メソッドがエラーなしでを返した場合、操作は非同期的に実行されます。 Windows は、IMbnSmsEvents の OnSmsSendComplete メソッドを呼び出すことによって、操作の完了状態についてアプリケーションに通知します。

要件

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

こちらもご覧ください

IMbnSms