Método IMbnConnection::GetVoiceCallState (mbnapi.h)
Importante
A partir do Windows 10, versão 1803, as APIs do Win32 descritas nesta seção são substituídas pelas APIs Windows Runtime no namespace Windows.Networking.Connectivity.
Obtém o estado da chamada de voz do dispositivo.
Sintaxe
HRESULT GetVoiceCallState(
[out, retval] MBN_VOICE_CALL_STATE *voiceCallState
);
Parâmetros
[out, retval] voiceCallState
Um ponteiro para um valor MBN_VOICE_CALL_STATE que especifica o estado da chamada de voz. Se o método retornar algo diferente de S_OK, o conteúdo desse ponteiro não será definido.
Valor retornado
Esse método pode retornar um desses valores.
| Código de retorno | Descrição |
|---|---|
|
O método foi concluído com sucesso. |
|
O estado da chamada não está disponível. O serviço de Banda Larga Móvel está sondando o dispositivo para obter as informações. O aplicativo de chamada pode ser notificado quando o estado da chamada está disponível registrando-se para o método OnVoiceCallStateChange de IMbnConnectionEvents. |
|
Um PIN é necessário para obter o estado da chamada. |
|
Um SIM não é inserido no dispositivo. |
|
Um SIM inválido é inserido no dispositivo. |
Comentários
Para os erros recuperáveis E_MBN_PIN_REQUIRED, E_MBN_SIM_NOT_INSERTED e E_MBN_BAD_SIM, o serviço de Banda Larga Móvel consultará o dispositivo novamente para obter essas informações quando a condição de erro terminar. Por exemplo, se o dispositivo exigiu que um PIN fosse inserido para recuperar o estado da chamada de voz, E_MBN_PIN_REQUIRED será retornado. Depois que o aplicativo de chamada entrar no PIN para desbloquear o dispositivo, o serviço de Banda Larga Móvel tentará novamente obter o estado da chamada de voz do dispositivo. O serviço de Banda Larga Móvel atualizará o aplicativo com o status de uma nova investigação chamando o método OnVoiceCallStateChange de IMbnConnectionEvents.
Requisitos
| Cliente mínimo com suporte | Windows 7 [aplicativos da área de trabalho | Aplicativos UWP] |
| Servidor mínimo com suporte | Nenhum compatível |
| Plataforma de Destino | Windows |
| Cabeçalho | mbnapi.h |