Metodo IMbnSms::SmsSendCdma (mbnapi.h)

Articolo
03/09/2023

Importante

A partire da Windows 10 versione 1803, le API Win32 descritte in questa sezione vengono sostituite dalle API Windows Runtime nello spazio dei nomi Windows.Networking.Connectivity.

Invia un messaggio in formato CDMA.

Sintassi

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
);

Parametri

[in] address

Stringa terminata null contenente il numero di telefono del ricevitore. La dimensione massima della stringa è di 15 cifre.

[in] encoding

Valore MBN_SMS_CDMA_ENCODING che specifica la codifica dei dati.

[in] language

Valore MBN_SMS_CDMA_LANG che specifica la lingua.

[in] sizeInCharacters

Numero di caratteri codificati nel messaggio. Ciò può essere diverso dalle dimensioni della matrice di messaggi.

[in] message

Matrice di byte contenente il messaggio CDMA codificato.

La dimensione massima di questa matrice è la proprietà CdmaShortMsgSize di IMbnSmsConfiguration, ma non può essere maggiore di MBN_CDMA_SHORT_MSG_SIZE_MAX (160).

[out] requestID

Puntatore a un ID richiesta emesso dal servizio Mobile Broadband per identificare questa richiesta.

Valore restituito

Questo metodo può restituire uno di questi valori.

Codice restituito	Descrizione
S_OK	Metodo completato correttamente.
HRESULT_FROM_WIN32(ERROR_SERVICE_NOT_ACTIVE)	Il servizio Mobile Broadband non è in esecuzione in questo sistema.
E_HANDLE	L'interfaccia non è valida, probabilmente perché il dispositivo è stato rimosso dal sistema.
HRESULT_FROM_WIN32(ERROR_NOT_FOUND)	L'interfaccia non è valida. Probabilmente il dispositivo Mobile Broadband è stato rimosso dal sistema.
HRESULT_FROM_WIN32(ERROR_NOT_SUPPORTED)	Il dispositivo non supporta l'invio di messaggi SMS nel formato richiesto. Ad esempio, se questa funzione viene chiamata per un dispositivo GSM.

Commenti

Questo metodo può essere usato per inviare un messaggio SMS per un dispositivo CDMA. Tuttavia, questo è solo quando il dispositivo CDMA supporta l'invio di SMS. Un'applicazione chiamante può imparare se il dispositivo supporta questo formato chiamando il metodo GetInterfaceCapability di IMbnInterface. Può quindi cercare MBN_SMS_CAPS_TEXT_SEND nel membro smsCaps di MBN_INTERFACE_CAPS.

Il parametro dell'indirizzo può essere in uno di questi formati.

"+ <International Country Code><SMS Service Center Number>\0"
"<SMS Service Center Number>\0"

Si tratta di un'operazione asincrona che restituirà immediatamente. Se il metodo restituisce senza errore, il servizio Mobile Broadband chiamerà il metodo OnSmsSendComplete dell'interfaccia IMbnSmsEvents .

Requisiti


Client minimo supportato	Windows 7 [solo app desktop]
Server minimo supportato	Nessuno supportato
Piattaforma di destinazione	Windows
Intestazione	mbnapi.h

Vedi anche

IMbnSms

Condividi tramite