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

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.

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

Voir aussi

IMbnConnectionProfileManager