Méthode IMbnMultiCarrierEvents ::OnSetHomeProviderComplete (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.

Cette méthode de notification est appelée par le service Haut débit mobile pour indiquer la fin d’une opération SetHomeProvider .

Syntaxe

HRESULT OnSetHomeProviderComplete(
  [in] IMbnMultiCarrier *mbnInterface,
  [in] ULONG            requestID,
  [in] HRESULT          status
);

Paramètres

[in] mbnInterface

Objet IMbnMultiCarrier qui représente l’opération SetHomeProvider de l’appareil haut débit mobile.

[in] requestID

ID de demande attribué par le service Haut débit mobile à l’opération SetHomeProvider .

[in] status

Un code status qui indique le résultat de SetHomeProvider.

Valeur	Signification
S_OK	L'opération a réussi.
E_MBN_PROVIDER_NOT_VISIBLE	Le fournisseur demandé n’est pas visible.
E_INVALIDARG	Entrée du mode d’inscription non valide, l’ID de fournisseur fourni comme entrée est plus long que la longueur maximale de 7 caractères, ou la classe de données fournie n’est pas valide. Le service Haut débit mobile n’envoie pas la demande à l’appareil lorsque des arguments non valides sont fournis dans l’entrée. En mode d’inscription manuelle, cela indique que le fournisseur demandé est interdit.
E_FAIL	L'opération n'a pas pu être terminée. Plus d’informations sont disponibles dans le code d’erreur réseau.
HRESULT_FROM_WIN32(ERROR_NOT_SUPPORTED)	L’opération n’est pas prise en charge par l’appareil. Cela peut être retourné par des appareils qui ne prennent pas en charge multifacteur.

Valeur retournée

Cette méthode doit retourner S_OK.

Remarques

Si status est S_OK, le fournisseur d’accueil de l’interface a été correctement défini sur le nouveau fournisseur par SetHomeProvider. Dans le cas contraire, le fournisseur d’accueil d’origine n’est pas modifié et les états précédents, tels que connexion, service de paquets, etc., de l’interface restent inchangés.

Configuration requise

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

Voir aussi

IMbnMultiCarrierEvents

Partager via