IMbnConnectionContext::SetProvisionedContext-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.

Fügt einen bereitgestellten Kontext hinzu oder aktualisiert diese.

Syntax

HRESULT SetProvisionedContext(
  [in]  MBN_CONTEXT provisionedContexts,
  [in]  LPCWSTR     providerID,
  [out] ULONG       *requestID
);

Parameter

[in] provisionedContexts

Eine MBN_CONTEXT-Struktur , die den bereitgestellten Kontext angibt, der auf dem Gerät oder der SIM gespeichert werden soll.

[in] providerID

Eine Zeichenfolge, die die Netzwerkanbieter-ID darstellt, für die der bereitgestellte Kontext gespeichert werden soll. Das Gerät sollte den hinzugefügten bereitgestellten Kontext als Antwort auf eine nachfolgende Abfrage zurückgeben, wenn sich eine SIM-Karte mit dieser Heimanbieter-ID im Gerät befindet.

[out] requestID

Eine Anforderungs-ID, die vom Mobilen Breitbanddienst festgelegt wurde, um diese asynchrone Anforderung zu identifizieren.

Rückgabewert

Diese Methode kann einen dieser Werte zurückgeben.

Rückgabecode	BESCHREIBUNG
S_OK	Die Methode wurde erfolgreich abgeschlossen.
E_HANDLE	Ungültige Schnittstelle. Höchstwahrscheinlich wurde das mobile Breitbandgerät aus dem System entfernt.
HRESULT_FROM_WIN32(ERROR_NOT_FOUND)	Ungültige Schnittstelle. Höchstwahrscheinlich wurde das mobile Breitbandgerät aus dem System entfernt.
HRESULT_FROM_WIN32(ERROR_SERVICE_NOT_ACTIVE)	Der mobile Breitbanddienst wird auf diesem System nicht ausgeführt.
E_INVALID_ARG	providerID ist ungültig.

Hinweise

Die contextID von provisionedContexts gibt den Index im Geräte- oder SIM-Speicher an, in dem der Kontext gespeichert werden soll. Wenn es auf MBN_CONTEXT_ID_APPEND festgelegt ist, muss das Gerät den entsprechenden Index finden, um den Kontext zu speichern.

Dies ist ein asynchroner Vorgang, und SetProvisionedContext wird sofort zurückgegeben. Nach Abschluss des Vorgangs benachrichtigt der Mobile Broadband-Dienst die Anwendung, indem er die OnSetProvisionedContextComplete-Methode von IMbnConnectionContextEvents aufruft.

Ergänzungen zur bereitgestellten Kontextliste für die aktuelle Heimanbieter-ID sind erst für Abfragen verfügbar, wenn die OnProvisionedContextListChange-Methode von IMbnConnectionContextEvents aufgerufen wurde.

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

IMbnConnectionContext