Méthode IMbnRegistration::SetRegisterMode (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.
Définit le mode d’inscription de l’appareil.
Syntaxe
HRESULT SetRegisterMode(
[in] MBN_REGISTER_MODE registerMode,
[in] LPCWSTR providerID,
[in] ULONG dataClass,
[out] ULONG *requestID
);
Paramètres
[in] registerMode
Valeur MBN_REGISTER_MODE qui spécifie le nouveau mode d’inscription.
[in] providerID
Chaîne qui spécifie l’ID du fournisseur de réseau auquel s’inscrire. Doit avoir la valeur NULL lorsque registerMode est MBN_REGISTER_MODE_AUTOMATIC.
[in] dataClass
Combinaison de bits de valeurs OR MBN_DATA_CLASS qui spécifient les technologies d’accès aux données préférées pour la connexion. Le service Haut débit mobile inscrit la technologie de classe de données la plus élevée disponible dans cette liste. Si aucune classe de données de cette liste ne peut être inscrite, le service haut débit mobile s’inscrit auprès de la meilleure classe de données disponible.
[out] requestID
ID de demande défini par le service Haut débit mobile pour identifier cette demande asynchrone.
Valeur retournée
Cette méthode peut retourner l’une de ces valeurs.
Code de retour | Description |
---|---|
|
La commande s'est correctement terminée. |
|
Le service haut débit mobile n’est pas en cours d’exécution sur ce système. |
|
L’interface n’est pas valide, probablement parce que l’appareil haut débit mobile a été supprimé du système. |
|
L’interface n’est pas valide. Très probablement, l’appareil haut débit mobile a été supprimé du système. |
|
Il existe déjà une connexion réseau active. Le mode d’inscription ne peut pas être modifié s’il existe une connexion de données déjà établie. L’application appelante doit d’abord déconnecter la connexion, puis essayer de modifier le mode d’inscription. Si l’appareil est déjà en mode demandé et connecté au fournisseur demandé, le code de retour est S_OK. |
Notes
La méthode SetRegisterMode peut être utilisée pour définir un appareil en mode de sélection réseau automatique ou manuelle. Pour le mode d’inscription manuelle, l’ID réseau auquel l’appareil doit s’inscrire est fourni dans providerID.
La prise en charge du mode d’inscription manuelle est facultative et l’application doit vérifier que l’appareil prend en charge l’inscription manuelle en recherchant MBN_CTRL_CAPS_REG_MANUAL dans le paramètre interfaceCaps renseigné par la méthode GetInterfaceCapability de IMbnInterface. Si une application définit le mode d’inscription manuelle et qu’il n’est pas pris en charge par l’appareil, cet appel retourne HRESULT_FROM_WIN32(ERROR_NOT_SUPPORTED).
SetRegisterMode est asynchrone et retourne immédiatement. En l’absence d’erreur, à la fin de l’opération, le service Haut débit mobile appelle la méthode OnSetRegisterModeComplete de IMbnRegistrationEvents.
Configuration requise
Client minimal pris en charge | Windows 7 [applications de bureau | Applications UWP] |
Serveur minimal pris en charge | Aucun pris en charge |
Plateforme cible | Windows |
En-tête | mbnapi.h |