IMbnConnectionContextEvents::OnSetProvisionedContextComplete-Methode (mbnapi.h)

Artikel
03/01/2024

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 vom Mobilen Breitbanddienst aufgerufen wird, um anzugeben, dass der bereitgestellte Kontext auf dem Gerät festgelegt wurde.

Syntax

HRESULT OnSetProvisionedContextComplete(
  [in] IMbnConnectionContext *newInterface,
  [in] ULONG                 requestID,
  [in] HRESULT               status
);

Parameter

[in] newInterface

Eine IMbnConnectionContext-Schnittstelle , die das Gerät darstellt, für das der Kontext festgelegt wurde.

[in] requestID

Eine Anforderungs-ID, die vom Mobilen Breitbanddienst festgelegt wurde, um den Vorgang zu identifizieren, der den Kontext festgelegt hat.

[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.
HRESULT_FROM_WIN32(ERROR_NOT_SUPPORTED)	Dieser Vorgang wird vom Gerät nicht unterstützt.
E_MBN_PIN_REQUIRED	Eine PIN ist erforderlich, damit der Vorgang abgeschlossen werden kann.
E_INVALIDARG	Die in der Anforderung angegebene Kontext-ID oder Anbieter-ID ist ungültig.
E_MBN_BAD_SIM	Auf dem Gerät ist eine schlechte SIM-Karte vorhanden.
HRESULT_FROM_WIN32(ERROR_WRITE_FAULT)	Ein Update im SIM- oder Gerätespeicher ist fehlgeschlagen.

Rückgabewert

Diese Methode muss S_OK zurückgeben.

Hinweise

Eine aufrufende Anwendung kann eine IMbnConnectionContext-Schnittstelle an newInterface übergeben, um die aktualisierte Liste der bereitgestellten Kontexte auf dem Gerät abzurufen. Da dieser Vorgang jedoch asynchron ist, muss die Anwendung auf die OnProvisionedContextListChange-Benachrichtigung warten, bevor sie diese Schnittstelle zum Abrufen der Kontexte verwendet.

Wenn mehrere Anwendungen zum Empfangen von Benachrichtigungen registriert sind, erhalten alle diese Benachrichtigungen, auch wenn nur eine von ihnen diesen Vorgang initiiert haben könnte.

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

IMbnConnectionContextEvents

Freigeben über