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

  • [アーティクル]

重要

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

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

構文

HRESULT SmsSendCdma(
  [in]  LPCWSTR               address,
  [in]  MBN_SMS_CDMA_ENCODING encoding,
  [in]  MBN_SMS_CDMA_LANG     language,
  [in]  ULONG                 sizeInCharacters,
  [in]  SAFEARRAY             *message,
  [out] ULONG                 *requestID
);

パラメーター

[in] address

受信者の電話番号を含む null で終わる文字列。 文字列の最大サイズは 15 桁です。

[in] encoding

データ エンコードを指定する MBN_SMS_CDMA_ENCODING 値。

[in] language

言語 を 指定するMBN_SMS_CDMA_LANG値。

[in] sizeInCharacters

メッセージ内のエンコードされた文字の数。 これは、メッセージ配列のサイズとは異なる場合があります。

[in] message

エンコードされた CDMA メッセージを含むバイト配列。

この配列の最大サイズは IMbnSmsConfiguration の CdmaShortMsgSize プロパティですが、MBN_CDMA_SHORT_MSG_SIZE_MAX (160) 以下にしてください。

[out] requestID

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

戻り値

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

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

解説

このメソッドは、CDMA デバイスの SMS メッセージを送信するために使用できます。 ただし、これは、CDMA デバイスが SMS の送信をサポートしている場合にのみ発生します。 呼び出し元のアプリケーションは、IMbnInterface の GetInterfaceCapability メソッドを呼び出すことによって、デバイスがこの形式をサポートしているかどうかを確認できます。 その後、 MBN_INTERFACE_CAPS の smsCaps メンバーで MBN_SMS_CAPS_TEXT_SENDを検索できます。

address パラメーターは、次のいずれかの形式で指定できます。

  • "+ <国際国コード><SMS サービス センター番号>\0"
  • "<SMS サービス センター番号>\0"

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

要件

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

関連項目

IMbnSms