Partager via


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

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.

Mises à jour la configuration SMS d’un appareil.

Syntaxe

HRESULT SetSmsConfiguration(
  [in]  IMbnSmsConfiguration *smsConfiguration,
  [out] ULONG                *requestID
);

Paramètres

[in] smsConfiguration

Interface IMbnSmsConfiguration représentant la nouvelle configuration SMS avec laquelle mettre à jour l’appareil.

[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 le 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.

Remarques

Une application peut utiliser SetSmsConfiguration pour modifier l’adresse du centre de service SMS par défaut dans l’appareil.

Une application doit effectuer les étapes suivantes pour définir la configuration SMS de l’appareil.

  1. Obtenez une interface IMbnSmsConfiguration en appelant GetSmsConfiguration.
  2. Modifiez l’interface IMbnSmsConfiguration obtenue à l’étape 1 avec les nouvelles valeurs qui reflètent les modifications souhaitées de la configuration.
  3. Passez le IMbnSmsConfiguration modifié à SetSmsConfiguration.
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 OnSetSmsConfigurationComplete 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

IMbnSmsConfiguration