Méthode IMbnConnectionProfileManager::GetConnectionProfiles (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.

Obtient la liste des profils de connexion associés à l’appareil.

Syntaxe

HRESULT GetConnectionProfiles(
  [in]          IMbnInterface *mbnInterface,
  [out, retval] SAFEARRAY     **connectionProfiles
);

Paramètres

[in] mbnInterface

IMbnInterface qui représente l’appareil auquel la demande de profil s’applique. Si la valeur est NULL, la fonction retourne tous les profils présents dans le système.

[out, retval] connectionProfiles

Tableau d’interfaces IMbnConnectionProfile qui représentent tous les profils de connexion disponibles pour l’appareil. Si cette méthode retourne autre chose que S_OK, le pointeur de tableau a la valeur NULL. Sinon, l’application appelante doit libérer la mémoire allouée en appelant SafeArrayDestroy.

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.
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_READY)	Le périphérique n’est pas prêt. Impossible d’obtenir l’ID d’abonné, car l’appareil n’est pas MBN_READY_STATE_INITIALIZED.
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.

Notes

Lorsque cette opération est appelée pour un appareil particulier, elle retourne une liste de profils qui ont le même ID d’abonné que celui actuellement signalé par l’appareil. La méthode GetSubscriberInformation de IMbnInterface peut être utilisée pour obtenir l’ID d’abonné associé à l’interface.

Un profil de connexion est associé à l’ID d’abonné de l’appareil. Pour les appareils GSM, l’ID d’abonné est l’identité imSI (International Mobile Subscriber Identity) de la carte SIM. Pour les appareils CDMA, il s’agit de la chaîne numéro d’identification mobile (MIN) ou de la chaîne IRM (International Roaming MIN).

Configuration requise


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

IMbnConnectionProfileManager

Partager via