IMbnConnection::GetVoiceCallState-Methode (mbnapi.h)
Wichtig
Ab Windows 10 Version 1803 werden die in diesem Abschnitt beschriebenen Win32-APIs durch die Windows-Runtime-APIs im Windows.Networking.Connectivity-Namespace ersetzt.
Ruft den Sprachanrufstatus des Geräts ab.
Syntax
HRESULT GetVoiceCallState(
[out, retval] MBN_VOICE_CALL_STATE *voiceCallState
);
Parameter
[out, retval] voiceCallState
Ein Zeiger auf einen MBN_VOICE_CALL_STATE Wert, der den Sprachanrufstatus angibt. Wenn die Methode etwas anderes als S_OK zurückgibt, werden die Inhalte dieses Zeigers nicht festgelegt.
Rückgabewert
Diese Methode kann einen dieser Werte zurückgeben.
| Rückgabecode | BESCHREIBUNG |
|---|---|
|
Die Methode wurde erfolgreich abgeschlossen. |
|
Der Aufrufstatus ist nicht verfügbar. Der Mobile Broadband-Dienst überprüft das Gerät nach den Informationen. Die aufrufende Anwendung kann benachrichtigt werden, wenn der Aufrufstatus verfügbar ist, indem sie sich für die OnVoiceCallStateChange-Methode von IMbnConnectionEvents registriert. |
|
Zum Abrufen des Anrufstatus ist eine PIN erforderlich. |
|
Eine SIM-Karte ist nicht in das Gerät eingefügt. |
|
Eine ungültige SIM-Karte wird in das Gerät eingefügt. |
Hinweise
Für die behebbaren Fehler E_MBN_PIN_REQUIRED, E_MBN_SIM_NOT_INSERTED und E_MBN_BAD_SIM fragt der Mobile Broadband-Dienst das Gerät erneut nach diesen Informationen ab, sobald die Fehlerbedingung abgelaufen ist. Wenn für das Gerät beispielsweise eine PIN eingegeben werden muss, um den Sprachanrufzustand abzurufen, wird E_MBN_PIN_REQUIRED zurückgegeben. Nachdem die aufrufende Anwendung die PIN eingegeben hat, um das Gerät zu entsperren, versucht der mobile Breitbanddienst erneut, den Sprachanrufstatus vom Gerät abzurufen. Der mobile Breitbanddienst aktualisiert die Anwendung mit der status eines neuen Tests, indem die OnVoiceCallStateChange-Methode von IMbnConnectionEvents aufgerufen wird.
Anforderungen
| Unterstützte Mindestversion (Client) | Windows 7 [Desktop-Apps | UWP-Apps] |
| Unterstützte Mindestversion (Server) | Nicht unterstützt |
| Zielplattform | Windows |
| Kopfzeile | mbnapi.h |