Méthode IMbnSms::SmsSendCdma (mbnapi.h)

Article
08/24/2023

Important

À compter de Windows 10, version 1803, les API Win32 décrites dans cette section sont remplacées par les API Windows Runtime dans l’espace de noms Windows.Networking.Connectivity.

Envoie un message au format CDMA.

Syntaxe

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

Paramètres

[in] address

Chaîne terminée par null qui contient le numéro de téléphone du récepteur. La taille maximale de la chaîne est de 15 chiffres.

[in] encoding

Valeur MBN_SMS_CDMA_ENCODING qui spécifie l’encodage des données.

[in] language

Valeur MBN_SMS_CDMA_LANG qui spécifie la langue.

[in] sizeInCharacters

Nombre de caractères encodés dans le message. Cela peut être différent de la taille du tableau de messages.

[in] message

Tableau d’octets contenant le message CDMA codé.

La taille maximale de ce tableau est la propriété CdmaShortMsgSize de IMbnSmsConfiguration, mais elle ne peut pas être supérieure à MBN_CDMA_SHORT_MSG_SIZE_MAX (160).

[out] requestID

Pointeur vers un ID de demande émis par le service haut débit mobile pour identifier cette demande.

Valeur retournée

Cette méthode peut retourner l’une de ces valeurs.

Code de retour	Description
S_OK	La commande s'est correctement terminée.
HRESULT_FROM_WIN32(ERROR_SERVICE_NOT_ACTIVE)	Le service haut débit mobile n’est pas en cours d’exécution sur ce système.
E_HANDLE	L’interface n’est pas valide, probablement parce que l’appareil a été supprimé du système.
HRESULT_FROM_WIN32(ERROR_NOT_FOUND)	L’interface n’est pas valide. Très probablement, l’appareil haut débit mobile a été supprimé du système.
HRESULT_FROM_WIN32(ERROR_NOT_SUPPORTED)	L’appareil ne prend pas en charge l’envoi de sms au format demandé. Par exemple, si cette fonction est appelée pour un appareil GSM.

Notes

Cette méthode peut être utilisée pour envoyer un SMS pour un appareil CDMA. Toutefois, cela est uniquement lorsque l’appareil CDMA prend en charge l’envoi de SMS. Une application appelante peut savoir si l’appareil prend en charge ce format en appelant la méthode GetInterfaceCapability d’IMbnInterface. Il peut ensuite rechercher MBN_SMS_CAPS_TEXT_SEND dans le membre smsCaps de MBN_INTERFACE_CAPS.

Le paramètre address peut être dans l’un de ces formats.

« + <International Country Code><SMS Service Center Number>\0 »
« <Numéro> du centre de service SMS\0 »

Il s’agit d’une opération asynchrone qui retourne immédiatement. Si la méthode retourne sans erreur, le service Haut débit mobile appelle la méthode OnSmsSendComplete de l’interface IMbnSmsEvents .

Spécifications


Client minimal pris en charge	Windows 7 [applications de bureau uniquement]
Serveur minimal pris en charge	Aucun pris en charge
Plateforme cible	Windows
En-tête	mbnapi.h

Voir aussi

IMbnSms

Partager via