IMbnSms::GetSmsConfiguration-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 die SMS-Konfiguration eines Geräts ab.
Syntax
HRESULT GetSmsConfiguration(
[out, retval] IMbnSmsConfiguration **smsConfiguration
);
Parameter
[out, retval] smsConfiguration
Eine IMbnSmsConfiguration-Schnittstelle , die die SMS-Konfiguration des Geräts darstellt.
Rückgabewert
Diese Methode kann einen dieser Werte zurückgeben.
| Rückgabecode | BESCHREIBUNG |
|---|---|
|
Die Methode wurde erfolgreich abgeschlossen. |
|
Die SMS-Konfiguration ist nicht verfügbar. Der Mobile Broadband-Dienst überprüft das Gerät nach den Informationen. Die aufrufende Anwendung kann benachrichtigt werden, wenn die SMS-Konfiguration verfügbar ist, indem sie sich für die OnSmsConfigurationChange-Methode der IMbnSmsEvents-Schnittstelle registriert. |
|
Zum Abrufen dieser Informationen ist eine PIN erforderlich. |
|
Es gibt keine SIM-Karte im Gerät. |
|
Es gibt eine ungültige SIM-Karte im Gerät. |
|
SMS wird vom Gerät nicht unterstützt. |
Hinweise
Bei wiederherstellbaren Fehlern wie 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, wenn der Fehlerzustand abgelaufen ist. Wenn das Gerät beispielsweise eine PIN eingeben muss, um diese Informationen abzurufen, wird E_MBN_PIN_REQUIRED zurückgegeben. Wenn eine Anwendung die PIN eingibt, um das Gerät zu entsperren, versucht der Mobile Broadband-Dienst erneut, diese Informationen vom Gerät abzurufen. Der mobile Breitbanddienst ruft die OnSmsConfigurationChange-Methode der IMbnSmsEvents-Schnittstelle auf .
Die SMS-Konfiguration kann vom Netzwerk oder Gerät aktualisiert werden, ohne dass eine Änderungsanforderung durch eine Anwendung erforderlich ist. In diesem Fall benachrichtigt der Mobile Broadband-Dienst alle registrierten Anwendungen, indem er die OnSmsConfigurationChange-Methode der IMbnSmsEvents-Schnittstelle aufruft .
Anforderungen
| Unterstützte Mindestversion (Client) | Windows 7 [nur Desktop-Apps] |
| Unterstützte Mindestversion (Server) | Nicht unterstützt |
| Zielplattform | Windows |
| Kopfzeile | mbnapi.h |