Méthode IMbnInterface::SetPreferredProviders (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 la liste des fournisseurs préférés pour l’appareil.

Syntaxe

HRESULT SetPreferredProviders(
  [in]  SAFEARRAY *preferredProviders,
  [out] ULONG     *requestID
);

Paramètres

[in] preferredProviders

Tableau de structures MBN_PROVIDER qui contient la liste des fournisseurs préférés.

[out] requestID

Pointeur vers l’ID de demande défini par le système d’exploitation pour cette demande. La réponse asynchrone contiendra ce même id de 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 ce système.
E_HANDLE	L’interface n’est pas valide, probablement parce que l’appareil haut débit mobile a été supprimé du système.
HRESULT_FROM_WIN32(ERROR_NOT_FOUND)	L’interface n’est pas valide. Probablement parce que l’appareil haut débit mobile a été supprimé du système.

Notes

La méthode SetPreferredProviders lance une mise à jour de la liste des fournisseurs préférés 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), le système d’exploitation informe l’application appelante de l’achèvement status de cette opération en appelant la méthode OnSetPreferredProvidersComplete d’IMbnInterfaceEvents.

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.

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

Voir aussi

IMbnInterface

Partager via