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

重要

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

メッセージを PDU 形式で送信します。

構文

HRESULT SmsSendPdu(
  [in]  LPCWSTR pduData,
  [in]  BYTE    size,
  [out] ULONG   *requestID
);

[in] pduData

PDU メッセージを 16 進数形式で表す文字列。

[in] size

16 進数の文字列形式に変換する前の PDU メッセージのサイズ (バイト数)。サービスセンターのアドレス長を除きます。

[out] requestID

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

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

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

pduData のこのデータは、3GPP TS 27.005 および 3GPP TS 23.040 で定義されている PDU 構造に準拠しています。

次の表は、メッセージ "Hello" を含む PDU メッセージの構成方法の例を示しています。

この関数は、PDU 形式の SMS の送信をサポートする GSM デバイスに対してのみ呼び出す必要があります。デバイスは、MBN_INTERFACE_CAPSで MBN_SMS_CAPS_PDU_SEND を設定することで、この機能を報告します。

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