Condividi tramite


Metodo IMbnConnection::GetVoiceCallState (mbnapi.h)

Importante

A partire da Windows 10 versione 1803, le API Win32 descritte in questa sezione vengono sostituite dalle API Windows Runtime nello spazio dei nomi Windows.Networking.Connectivity.

Ottiene lo stato della chiamata vocale del dispositivo.

Sintassi

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

Parametri

[out, retval] voiceCallState

Puntatore a un valore MBN_VOICE_CALL_STATE che specifica lo stato della chiamata vocale. Se il metodo restituisce qualsiasi elemento diverso da S_OK, il contenuto di questo puntatore non è impostato.

Valore restituito

Questo metodo può restituire uno di questi valori.

Codice restituito Descrizione
S_OK
Metodo completato correttamente.
E_PENDING
Lo stato della chiamata non è disponibile. Il servizio Mobile Broadband sta verificando il dispositivo per le informazioni. L'applicazione chiamante può ricevere una notifica quando lo stato della chiamata è disponibile registrando per il metodo OnVoiceCallStateChange di IMbnConnectionEvents.
E_MBN_PIN_REQUIRED
È necessario un PIN per ottenere lo stato della chiamata.
E_MBN_SIM_NOT_INSERTED
Una SIM non viene inserita nel dispositivo.
E_MBN_BAD_SIM
Una SIM non valida viene inserita nel dispositivo.

Commenti

Per gli errori recuperabili E_MBN_PIN_REQUIRED, E_MBN_SIM_NOT_INSERTED e E_MBN_BAD_SIM, il servizio Mobile Broadband eseguirà nuovamente una query sul dispositivo per queste informazioni dopo che la condizione di errore è finita. Ad esempio, se il dispositivo ha richiesto l'immissione di un PIN per recuperare lo stato della chiamata vocale, E_MBN_PIN_REQUIRED viene restituito. Dopo che l'applicazione chiamante immette il PIN per sbloccare il dispositivo, il servizio Mobile Broadband tenterà nuovamente di ottenere lo stato della chiamata vocale dal dispositivo. Il servizio Mobile Broadband aggiornerà l'applicazione con lo stato di un nuovo probe chiamando il metodo OnVoiceCallStateChange di IMbnConnectionEvents.

Requisiti

   
Client minimo supportato Windows 7 [app desktop | App UWP]
Server minimo supportato Nessuno supportato
Piattaforma di destinazione Windows
Intestazione mbnapi.h

Vedi anche

IMbnConnection