Partager via

Méthode IMbnConnectionProfileManager ::GetConnectionProfile (mbnapi.h)

  • Article

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 un profil de connexion spécifique associé à l’appareil haut débit mobile donné.

Syntaxe

HRESULT GetConnectionProfile(
  [in]          IMbnInterface         *mbnInterface,
  [in]          LPCWSTR               profileName,
  [out, retval] IMbnConnectionProfile **connectionProfile
);

Paramètres

[in] mbnInterface

IMbnInterface qui représente l’appareil pour lequel la demande de profil s’applique. Si mbnInterface a la valeur NULL, cette fonction retourne le profil du nom donné associé à n’importe quel appareil dans le système.

[in] profileName

Chaîne terminée par null qui contient le nom du profil de connexion.

[out, retval] connectionProfile

Interface IMbnConnectionProfile qui représente le profil de connexion souhaité. Si cette méthode retourne autre chose que S_OK, cette valeur est NULL.

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_FOUND)
 Un profil portant le nom donné n’existe pas.
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_NOT_FOUND)
 Un profil portant le nom donné n’existe pas.

Remarques

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 MIN (Mobile Identification Number) ou de la chaîne IRM (International Roaming MIN).

Si un nouveau profil a été créé à l’aide de CreateConnectionProfile, l’appelant doit attendre que l’événement OnConnectionProfileArrival soit reçu avant d’appeler GetConnectionProfile avec le nom du nouveau profil ; sinon, l’appel de l’API GetConnectionProfile peut échouer avec HRESULT_FROM_WIN32(ERROR_NOT_FOUND) .

Configuration requise

Condition requise Valeur
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