IMbnSms：：SmsSendPdu 方法 (mbnapi.h)

重要

從 Windows 10 1803 版開始，本節所述的 Win32 API 會由 Windows.Networking.Connectivity 命名空間中的 Windows 執行階段 API 取代。

以 PDU 格式傳送訊息。

語法

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

[in] pduData

字串，表示十六進位格式的 PDU 訊息。

[in] size

轉換成十六進位字串格式並排除服務中心地址長度之前，以位元元組數為單位的 PDU 訊息大小。

[out] requestID

行動寬頻服務發出之要求標識碼的指標，用來識別此要求。

這個方法可以傳回下列其中一個值。

傳回碼	描述
S_OK	已成功完成命令。
E_INVALIDARG	pduData 或 size 無效。
HRESULT_FROM_WIN32 (ERROR_SERVICE_NOT_ACTIVE)	行動寬頻服務未在此系統上執行。
E_HANDLE	介面無效，很可能是因為裝置已從系統中移除。
HRESULT_FROM_WIN32 (ERROR_NOT_FOUND)	介面無效。很可能已從系統移除行動寬頻裝置。
HRESULT_FROM_WIN32 (ERROR_NOT_SUPPORTED)	裝置不支援以要求的格式傳送簡訊。例如，如果針對CDMA裝置呼叫此函式。

pduData 中的數據符合 3GPP TS 27.005 和 3GPP TS 23.040 中定義的 PDU 結構。

下表顯示 PDU 訊息的範例，其中包含「Hello」訊息的結構。

只有支援以 PDU 格式傳送 SMS 的 GSM 裝置，才應該呼叫此函式。裝置會在 MBN_INTERFACE_CAPS 中設定MBN_SMS_CAPS_PDU_SEND來報告這項功能。

這是會立即傳回的異步操作。如果方法傳回時沒有錯誤，則行動寬頻服務會呼叫 IMbnSmsEvents 介面的 OnSmsSendComplete 方法。