Metodo IMbnSms::SmsSendPdu (mbnapi.h)

Articolo
08/24/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 PDU.

Sintassi

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

Parametri

[in] pduData

Stringa che rappresenta il messaggio PDU in formato esadecimale.

[in] size

Dimensioni del messaggio PDU in numero di byte prima di convertire in formato stringa esadecimale ed escludere la lunghezza dell'indirizzo del centro servizi.

[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.
E_INVALIDARG	pduData o dimensione non sono validi.
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 CDMA.

Commenti

Questi dati in pduData sono conformi alla struttura PDU definita in TS 3GPP TS 27.005 e 3GPP TS 23.040.

La tabella seguente mostra un esempio di come un messaggio PDU contenente il messaggio "Hello" sarebbe strutturato.

Esempio	07	91198994000010	11000A9189945086180000AA005C8329BFD06
Contenuto	Dimensioni dell'indirizzo del Centro servizi	Indirizzo del Centro servizi	PDU in formato esadecimale
Dimensione	1 byte	Variabile	Variabile

Questa funzione deve essere chiamata solo per i dispositivi GSM che supportano l'invio di SMS in formato PDU. Un dispositivo segnala questa capacità impostando MBN_SMS_CAPS_PDU_SEND in MBN_INTERFACE_CAPS.

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

Requisito	Valore
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