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

Article
03/02/2024

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 PDU.

Syntaxe

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

Paramètres

[in] pduData

Chaîne représentant le message PDU au format hexadécimal.

[in] size

Taille du message PDU en nombre d’octets avant de convertir au format de chaîne hexadécimale et d’exclure la longueur de l’adresse du centre de service.

[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.
E_INVALIDARG	pduData ou size ne sont pas valides.
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 CDMA.

Remarques

Ces données dans pduData sont conformes à la structure PDU définie dans 3GPP TS 27.005 et 3GPP TS 23.040.

Le tableau ci-dessous montre un exemple de structure d’un message PDU contenant le message « Hello ».

Exemple	07	91198994000010	11000A9189945086180000AA05C8329BFD06
Contenu	Taille de l’adresse du Centre de service	Adresse du Centre de service	PDU au format hexadécimal
Taille	1 octet	Variable	Variable

Cette fonction doit être appelée uniquement pour les appareils GSM qui prennent en charge l’envoi de SMS au format PDU. Un appareil signale cette fonctionnalité en définissant MBN_SMS_CAPS_PDU_SEND dans MBN_INTERFACE_CAPS.

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 .

Configuration requise

Condition requise	Valeur
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