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 |
---|---|
|
Metodo completato correttamente. |
|
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. |
|
È necessario un PIN per ottenere lo stato della chiamata. |
|
Una SIM non viene inserita nel dispositivo. |
|
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 |