IMbnSms::SmsRead-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.
Liest eine Reihe von SMS-Nachrichten von einem Gerät.
Syntax
HRESULT SmsRead(
[in] MBN_SMS_FILTER *smsFilter,
[in] MBN_SMS_FORMAT smsFormat,
[out] ULONG *requestID
);
Parameter
[in] smsFilter
Ein Zeiger auf eine MBN_SMS_FILTER Struktur, die den Satz der zu lesenden Nachrichten definiert.
[in] smsFormat
Ein MBN_SMS_FORMAT Wert, der das Format angibt, in dem eine SMS-Nachricht gelesen werden soll.
Bei GSM-Geräten sollte es immer MBN_SMS_FORMAT_PDU sein.
Wenn dies für CDMA-Geräte als MBN_SMS_FORMAT_PDU angegeben ist, liest das Gerät eine CDMA-Meldung im Binärmodus. Wenn es als MBN_SMS_FORMAT_TEXT angegeben wird, liest das Gerät eine CDMA-Nachricht im Textmodus. Wenn das Gerät das angegebene Format nicht unterstützt, kann es einen Fehlercode zurückgeben.
[out] requestID
Ein Zeiger auf eine Anforderungs-ID, die vom Mobilen Breitbanddienst ausgestellt wurde, um diese Anforderung zu identifizieren.
Rückgabewert
Diese Methode kann einen dieser Werte zurückgeben.
| Rückgabecode | BESCHREIBUNG |
|---|---|
|
Die Methode wurde erfolgreich abgeschlossen. |
|
Der mobile Breitbanddienst wird auf diesem System nicht ausgeführt. |
|
Die Schnittstelle ist ungültig, wahrscheinlich, weil das Gerät aus dem System entfernt wurde. |
|
Die Schnittstelle ist ungültig. Höchstwahrscheinlich wurde das mobile Breitbandgerät aus dem System entfernt. |
|
smsFormat oder smsFilter ist ungültig. |
Hinweise
Mithilfe von smsFilter kann eine Anwendung grundlegende Filter angeben, z. B. neue Nachrichten, Nachrichtenentwürfe oder eine bestimmte Nachricht mithilfe eines Indexes. Ein komplexer Filter kann verwendet werden, indem eine Kombination aus grundlegenden Filtern integriert wird. Alle Schnittstellen unterstützen indexbasierte Filter und neue Nachrichtentypfilter. Die Unterstützung für andere Filter ist für einige Schnittstellen optional. Wenn der angegebene Filter nicht unterstützt wird, gibt die Rückruffunktion für den Vorgangsabschluss eine status E_MBN_STATUS_FILTER_NOT_SUPPORTED zurück.
Dies ist ein asynchroner Vorgang, der sofort zurückgegeben wird. Wenn die Methode ohne Fehler zurückgegeben wird, ruft der Mobile Broadband-Dienst die OnSmsReadComplete-Methode der IMbnSmsEvents-Schnittstelle auf.
Anforderungen
| Unterstützte Mindestversion (Client) | Windows 7 [nur Desktop-Apps] |
| Unterstützte Mindestversion (Server) | Nicht unterstützt |
| Zielplattform | Windows |
| Kopfzeile | mbnapi.h |