IMbnSmsEvents：：OnSmsSendComplete 方法 (mbnapi.h)

重要

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

指出訊息傳送作業完成的通知方法。

語法

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

[in] sms

IMbnSms 介面，代表作業完成所在的行動寬頻裝置。

[in] requestID

行動寬頻服務指派的要求標識碼，以識別作業。

[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	SIM 卡不允許要求的SMS作業。
E_MBN_SMS_MEMORY_FULL	裝置/SIM 記憶體已滿。

這個方法必須傳回 S_OK。

只有在裝置成功註冊到網路之後，才應該嘗試傳送作業。