IMbnSms::GetSmsStatus-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-status für ein Gerät ab.
Syntax
HRESULT GetSmsStatus(
[out] MBN_SMS_STATUS_INFO *smsStatusInfo
);
Parameter
[out] smsStatusInfo
Ein Zeiger auf eine MBN_SMS_STATUS_INFO-Struktur, die die status Informationen für das Gerät enthält.
Rückgabewert
Diese Methode kann einen dieser Werte zurückgeben.
| Rückgabecode | BESCHREIBUNG |
|---|---|
|
Die Methode wurde erfolgreich abgeschlossen. |
|
Die SMS-status ist nicht verfügbar. Der Mobile Broadband-Dienst überprüft das Gerät nach den Informationen. Die aufrufende Anwendung kann benachrichtigt werden, wenn der SMS-status verfügbar ist, indem sie sich für die OnSmsStatusChange-Methode der IMbnSmsEvents-Schnittstelle registriert. |
|
Zum Abrufen dieser Informationen 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
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 OnSmsStatusChange-Methode der IMbnSmsEvents-Schnittstelle auf .
Der SMS-Nachrichtenspeicher status kann sich aufgrund einer neuen Nachricht ändern, die vom System empfangen wird. Bei jeder Änderung im Nachrichtenspeicher status ruft der Mobile Broadband-Dienst die OnSmsStatusChange-Methode der IMbnSmsEvent-Schnittstelle auf.
Von der Anwendung ausgestellte Vorgänge wie das Lesen oder Löschen von Nachrichten können das Flag in MBN_SMS_STATUS_INFO Struktur zurückgesetzt werden. Eine durch diese Zurücksetzung verursachte Änderung im SMS-Speicher führt nicht zum Aufruf einer Benachrichtigungsmethode.
Anforderungen
| Unterstützte Mindestversion (Client) | Windows 7 [nur Desktop-Apps] |
| Unterstützte Mindestversion (Server) | Nicht unterstützt |
| Zielplattform | Windows |
| Kopfzeile | mbnapi.h |