Méthode IMbnConnection::GetVoiceCallState (mbnapi.h)
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 l’état des appels vocaux de l’appareil.
Syntaxe
HRESULT GetVoiceCallState(
[out, retval] MBN_VOICE_CALL_STATE *voiceCallState
);
Paramètres
[out, retval] voiceCallState
Pointeur vers une valeur MBN_VOICE_CALL_STATE qui spécifie l’état de l’appel vocal. Si la méthode retourne autre chose que S_OK, le contenu de ce pointeur n’est pas défini.
Valeur retournée
Cette méthode peut retourner l’une de ces valeurs.
| Code de retour | Description |
|---|---|
|
La commande s'est correctement terminée. |
|
État de l’appel non disponible. Le service Haut débit mobile sonde l’appareil à des fins d’information. L’application appelante peut être avertie lorsque l’état de l’appel est disponible en s’inscrivant à la méthode OnVoiceCallStateChange de IMbnConnectionEvents. |
|
Un code confidentiel est nécessaire pour obtenir l’état de l’appel. |
|
Aucune carte SIM n’est insérée dans l’appareil. |
|
Une carte SIM incorrecte est insérée dans l’appareil. |
Notes
Pour les erreurs récupérables E_MBN_PIN_REQUIRED, E_MBN_SIM_NOT_INSERTED et E_MBN_BAD_SIM, le service Haut débit mobile interroge à nouveau l’appareil pour obtenir ces informations une fois la condition d’erreur terminée. Par exemple, si l’appareil a requis la saisie d’un code confidentiel pour récupérer l’état de l’appel vocal, E_MBN_PIN_REQUIRED est retourné. Une fois que l’application appelante a entré le code confidentiel pour déverrouiller l’appareil, le service haut débit mobile tente à nouveau d’obtenir l’état de l’appel vocal à partir de l’appareil. Le service Haut débit mobile met à jour l’application avec la status d’une nouvelle sonde en appelant la méthode OnVoiceCallStateChange de IMbnConnectionEvents.
Spécifications
| 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 |