IMbnSmsEvents::OnSmsReadComplete-Methode (mbnapi.h)

  • Artikel

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.

Benachrichtigungsmethode, die den Abschluss eines Nachrichtenlesevorgangs angibt.

Syntax

HRESULT OnSmsReadComplete(
  [in] IMbnSms        *sms,
  [in] MBN_SMS_FORMAT smsFormat,
  [in] SAFEARRAY      *readMsgs,
  [in] VARIANT_BOOL   moreMsgs,
  [in] ULONG          requestID,
  [in] HRESULT        status
);

Parameter

[in] sms

Eine IMbnSms-Schnittstelle , die den Nachrichtenspeicher darstellt, der den Vorgang abgeschlossen hat.

[in] smsFormat

Ein MBN_SMS_FORMAT Wert, der das Format der SMS-Nachricht definiert.

[in] readMsgs

Ein Array von Nachrichten, die vom Gerät gelesen werden.

[in] moreMsgs

Ein boolescher Wert, der angibt, ob noch weitere Nachrichten verarbeitet werden. Wenn dies TRUE ist, wird OnSmsReadComplete wiederholt aufgerufen, bis keine weiteren Meldungen vorhanden sind und mehrMsgsfalse ist.

[in] requestID

Eine Anforderungs-ID, die vom mobilen Breitbanddienst zugewiesen wird, um den Nachrichtenlesevorgang zu identifizieren.

[in] status

Ein status Code, der das Ergebnis des Vorgangs angibt.

Eine aufrufende Anwendung kann einen der folgenden Werte erwarten.

Wert Bedeutung
S_OK
 Der Vorgang wurde durchgeführt.
E_MBN_SIM_NOT_INSERTED
 Es gibt keine SIM-Karte im Gerät.
E_MBN_BAD_SIM
 Es gibt eine ungültige SIM-Karte im Gerät.
E_MBN_PIN_REQUIRED
 Für den Abschluss des Vorgangs ist eine PIN erforderlich.
HRESULT_FROM_WIN32(ERROR_NOT_SUPPORTED)
 Der SMS-Vorgang oder das bestimmte SMS-Format wird vom Gerät nicht unterstützt.
E_MBN_SMS_MEMORY_FAILURE
 SMS-Speicherfehler.
E_MBN_SMS_INVALID_MEMORY_INDEX
 Es gibt keinen Speicherindex mit dem angeforderten Wert.
E_MBN_SMS_FILTER_NOT_SUPPORTED
 Das Gerät unterstützt den angeforderten Filter nicht.

Rückgabewert

Diese Methode muss S_OK zurückgeben.

Hinweise

Bei GSM-Geräten sollte die aufrufende Anwendung QueryInterface für jedes Element in readMsgs für eine IMbnSmsReadMsgPdu-Schnittstelle aufrufen.

Wenn smsFormat für CDMA-Geräte MBN_SMS_FORMAT_TEXT ist, sollte die Anwendung QueryInterface für eine IMbnSmsReadMsgTextCdma-Schnittstelle aufrufen. Andernfalls sollte die Anwendung QueryInterface für eine IMbnSmsReadMsgPdu-Schnittstelle aufrufen, wenn smsFormatMBN_SMS_FORMAT_PDU ist.

Wenn eine Leseanforderung zu einer großen Anzahl von Nachrichten führt, die gelesen werden, wird OnSmsReadComplete möglicherweise wiederholt aufgerufen, bis moreMsgs angibt, dass keine Nachrichten mehr gelesen werden müssen.

Anforderungen

   
Unterstützte Mindestversion (Client) Windows 7 [nur Desktop-Apps]
Unterstützte Mindestversion (Server) Nicht unterstützt
Zielplattform Windows
Kopfzeile mbnapi.h

Weitere Informationen

IMbnSmsEvents