IMbnSms::SmsRead-Methode (mbnapi.h)

Artikel
08/24/2023

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
S_OK	Die Methode wurde erfolgreich abgeschlossen.
HRESULT_FROM_WIN32(ERROR_SERVICE_NOT_ACTIVE)	Der mobile Breitbanddienst wird auf diesem System nicht ausgeführt.
E_HANDLE	Die Schnittstelle ist ungültig, wahrscheinlich, weil das Gerät aus dem System entfernt wurde.
HRESULT_FROM_WIN32(ERROR_NOT_FOUND)	Die Schnittstelle ist ungültig. Höchstwahrscheinlich wurde das mobile Breitbandgerät aus dem System entfernt.
E_INVALIDARG	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

Weitere Informationen

IMbnSms

Freigeben über