Méthode IMbnMultiCarrier::SetHomeProvider (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.

Mises à jour le fournisseur d’accueil pour un appareil multifacteur.

Syntaxe

HRESULT SetHomeProvider(
  [in]  MBN_PROVIDER2 *homeProvider,
  [out] ULONG         *requestID
);

Paramètres

[in] homeProvider

Structure MBN_PROVIDER2 qui contient le fournisseur d’accueil.

Remarque

Les membres SignalStrength et SignalError doivent être 0.

[out] requestID

Pointeur vers l’ID de demande défini par le système d’exploitation pour cette requête. La réponse asynchrone de OnSetHomeProviderComplete contient ce même requestID.

Pointeur vers l’ID de demande défini par le système d’exploitation pour cette requête. La réponse asynchrone contient ce même requestID.

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	Interface non valide. L’appareil haut débit mobile a probablement été supprimé du système.
HRESULT_FROM_WIN32(ERROR_NOT_FOUND)	Interface non valide. Très probablement, l’appareil haut débit mobile a été supprimé du système.
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.

Notes

La méthode SetHomeProvider lance une mise à jour du fournisseur de base pour l’interface. Il s’agit d’une opération asynchrone, et l’appel de méthode retourne immédiatement. Si cette méthode retourne correctement avec S_OK, Windows informe l’application appelante de l’achèvement status de cette opération en appelant la méthode OnSetHomeProviderComplete de IMbnMultiCarrierEvents.

L’appareil est alors automatiquement inscrit sur le nouveau réseau et indique un changement d’état d’inscription. L’appareil continuera d’être inscrit sur ce nouveau réseau domestique lors des redémarrages de Windows, sauf si SetHomeProvider est utilisé à nouveau pour définir un nouveau fournisseur d’accueil.

Si l’appareil est supprimé du système avant la fin de cette opération, il n’y a aucune garantie que la notification d’achèvement sera reçue par l’application appelante.

Spécifications


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

IMbnMultiCarrier

Partager via