Partager via

Méthode IMbnConnection::GetVoiceCallState (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 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
S_OK
 La commande s'est correctement terminée.
E_PENDING
 É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.
E_MBN_PIN_REQUIRED
 Un code confidentiel est nécessaire pour obtenir l’état de l’appel.
E_MBN_SIM_NOT_INSERTED
 Aucune carte SIM n’est insérée dans l’appareil.
E_MBN_BAD_SIM
 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

Voir aussi

IMbnConnection