IMbnSms::SetSmsConfiguration-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.

Updates die SMS-Konfiguration für ein Gerät.

Syntax

HRESULT SetSmsConfiguration(
  [in]  IMbnSmsConfiguration *smsConfiguration,
  [out] ULONG                *requestID
);

Parameter

[in] smsConfiguration

Eine IMbnSmsConfiguration-Schnittstelle , die die neue SMS-Konfiguration darstellt, mit der das Gerät aktualisiert werden soll.

[out] requestID

Ein Zeiger auf eine Vom Mobilen Breitbanddienst ausgestellte Anforderungs-ID, 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 nicht auf dem System ausgeführt.
E_HANDLE
Die Schnittstelle ist ungültig, höchstwahrscheinlich, 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.

Hinweise

Eine Anwendung kann SetSmsConfiguration verwenden, um die Standardadresse des SMS Service Centers auf dem Gerät zu ändern.

Eine Anwendung sollte die folgenden Schritte zum Festlegen der SMS-Konfiguration des Geräts ausführen.

  1. Rufen Sie eine IMbnSmsConfiguration-Schnittstelle ab, indem Sie GetSmsConfiguration aufrufen.
  2. Ändern Sie die aus Schritt 1 abgerufene IMbnSmsConfiguration-Schnittstelle mit den neuen Werten, die die gewünschten Änderungen an der Konfiguration widerspiegeln.
  3. Übergeben Sie die geänderte IMbnSmsConfiguration an SetSmsConfiguration.
Dies ist ein asynchroner Vorgang, der sofort zurückgegeben wird. Wenn die Methode ohne Fehler zurückgibt, ruft der Mobile Broadband-Dienst die OnSetSmsConfigurationComplete-Methode der IMbnSmsEvents-Schnittstelle auf .

Anforderungen

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

Weitere Informationen

IMbnSms

IMbnSmsConfiguration