IMbnServiceActivation::Activate-Methode (mbnapi.h)

Artikel
02/28/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.

Senden Sie die Dienstaktivierungsanforderung an das Netzwerk.

Syntax

HRESULT Activate(
  [in]  SAFEARRAY *vendorSpecificData,
  [out] ULONG     *requestID
);

Parameter

[in] vendorSpecificData

Ein anbieterspezifisches Array von Bytes, die in einem Dienstaktivierungsvorgang übergeben werden. Diese Daten werden vom Mobilen Breitbanddienst in einer SET-OID_WWAN_SERVICE_ACTIVATION OID-Anforderung an den Miniporttreiber übergeben.

[out] requestID

Die Anforderungs-ID für diesen Vorgang.

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	Ungültige Schnittstelle. Höchstwahrscheinlich wurde das Gerät aus dem System entfernt.
HRESULT_FROM_WIN32(ERROR_NOT_FOUND)	Die Schnittstelle ist ungültig. Höchstwahrscheinlich wurde das mobile Breitbandgerät aus dem System entfernt. Ungültige Schnittstelle. Höchstwahrscheinlich wurde das Gerät aus dem System entfernt.

Hinweise

Die Activate-Methode kann von einer Anwendung verwendet werden, um den Mobilfunkdienst zu aktivieren. Das Format der in dieser Anforderung übergebenen Daten ist herstellerspezifisch.

Das VendorSpecificBufferSize-Feld der OID-Anforderung wird auf die Größe der Daten im SAFEARRAY, vendorSpecificData, festgelegt. Der Inhalt von vendorSpecificData wird byte-by-byte in die OID-Anforderung in den Treiber kopiert.

Weitere Informationen zu Dienstaktivierungsvorgängen finden Sie im Treibermodell für mobiles Breitband.

Dies ist ein asynchroner Vorgang, der sofort zurückgegeben wird. Wenn die Methode ohne Fehler zurückgegeben wird, ruft der Mobile Broadband-Dienst die OnActivationComplete-Methode der IMbnServiceActivationEvents-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

IMbnServiceActivation

Freigeben über