Método IMbnConnection::GetVoiceCallState (mbnapi.h)

Importante

A partir de Windows 10, versión 1803, las API de Win32 descritas en esta sección se reemplazan por las API de Windows Runtime en el espacio de nombres Windows.Networking.Connectivity.

Obtiene el estado de llamada de voz del dispositivo.

Sintaxis

HRESULT GetVoiceCallState(
  [out, retval] MBN_VOICE_CALL_STATE *voiceCallState
);

Parámetros

[out, retval] voiceCallState

Puntero a un valor de MBN_VOICE_CALL_STATE que especifica el estado de la llamada de voz. Si el método devuelve algo distinto de S_OK, no se establece el contenido de este puntero.

Valor devuelto

Este método puede devolver uno de estos valores.

Código devuelto	Descripción
S_OK	El método se completó correctamente.
E_PENDING	El estado de llamada no está disponible. El servicio de banda ancha móvil está sondeando el dispositivo para obtener la información. La aplicación que realiza la llamada se puede notificar cuando el estado de llamada está disponible registrando para el método OnVoiceCallStateChange de IMbnConnectionEvents.
E_MBN_PIN_REQUIRED	Se requiere un PIN para obtener el estado de la llamada.
E_MBN_SIM_NOT_INSERTED	No se inserta una SIM en el dispositivo.
E_MBN_BAD_SIM	Se inserta una SIM incorrecta en el dispositivo.

Comentarios

En el caso de los errores recuperables E_MBN_PIN_REQUIRED, E_MBN_SIM_NOT_INSERTED y E_MBN_BAD_SIM, el servicio de banda ancha móvil consultará de nuevo el dispositivo para obtener esta información una vez finalizada la condición de error. Por ejemplo, si el dispositivo requiere que se escriba un PIN para recuperar el estado de la llamada de voz, se devuelve E_MBN_PIN_REQUIRED . Una vez que la aplicación que llama entra en el PIN para desbloquear el dispositivo, el servicio de banda ancha móvil volverá a intentar obtener el estado de la llamada de voz del dispositivo. El servicio de banda ancha móvil actualizará la aplicación con el estado de un nuevo sondeo llamando al método OnVoiceCallStateChange de IMbnConnectionEvents.

Requisitos

Cliente mínimo compatible	Windows 7 [aplicaciones de escritorio | Aplicaciones para UWP]
Servidor mínimo compatible	No se admite ninguno
Plataforma de destino	Windows
Encabezado	mbnapi.h

Consulte también

IMbnConnection