Hinweis
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, sich anzumelden oder das Verzeichnis zu wechseln.
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, das Verzeichnis zu wechseln.
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.
Legt den Registrierungsmodus für das Gerät fest.
Syntax
HRESULT SetRegisterMode(
[in] MBN_REGISTER_MODE registerMode,
[in] LPCWSTR providerID,
[in] ULONG dataClass,
[out] ULONG *requestID
);
Parameter
[in] registerMode
Ein MBN_REGISTER_MODE Wert, der den neuen Registrierungsmodus angibt.
[in] providerID
Eine Zeichenfolge, die die Anbieter-ID des Netzwerkanbieters angibt, bei dem registriert werden soll. Muss NULL sein, wenn registerModeMBN_REGISTER_MODE_AUTOMATIC ist.
[in] dataClass
Eine bitweise Kombination von OR MBN_DATA_CLASS Werte, die die bevorzugten Datenzugriffstechnologien für die Verbindung angeben. Der mobile Breitbanddienst registriert die höchste verfügbare Datenklassentechnologie aus dieser Liste. Wenn keine Datenklasse aus dieser Liste registriert werden kann, wird der mobile Breitbanddienst für die beste verfügbare Datenklasse registriert.
[out] requestID
Eine Anforderungs-ID, die vom Mobilen Breitbanddienst festgelegt wird, um diese asynchrone Anforderung zu identifizieren.
Rückgabewert
Diese Methode kann einen dieser Werte zurückgeben.
| Rückgabecode | BESCHREIBUNG |
|---|---|
|
Die Methode wurde erfolgreich abgeschlossen. |
|
Der mobile Breitbanddienst wird auf diesem System nicht ausgeführt. |
|
Die Schnittstelle ist ungültig, höchstwahrscheinlich, weil das mobile Breitbandgerät aus dem System entfernt wurde. |
|
Die Schnittstelle ist ungültig. Höchstwahrscheinlich wurde das mobile Breitbandgerät aus dem System entfernt. |
|
Es besteht bereits eine aktive Netzwerkverbindung. Der Registrierungsmodus kann nicht geändert werden, während eine bereits hergestellte Datenverbindung besteht. Die aufrufende Anwendung sollte zuerst die Verbindung trennen und dann versuchen, den Registrierungsmodus zu ändern. Wenn sich das Gerät bereits im angeforderten Modus befindet und mit dem angeforderten Anbieter verbunden ist, wird der Rückgabecode S_OK. |
Hinweise
Die SetRegisterMode-Methode kann verwendet werden, um ein Gerät in den automatischen oder manuellen Netzwerkauswahlmodus festzulegen. Für den manuellen Registrierungsmodus wird die Netzwerk-ID, bei der sich das Gerät registrieren soll, in providerID angegeben.
Die Unterstützung für den manuellen Registrierungsmodus ist optional, und die Anwendung sollte überprüfen, ob das Gerät die manuelle Registrierung unterstützt, indem sie im parameter interfaceCaps nach MBN_CTRL_CAPS_REG_MANUAL sucht, der von der GetInterfaceCapability-Methode von IMbnInterface ausgefüllt wird. Wenn eine Anwendung den manuellen Registrierungsmodus festlegt und vom Gerät nicht unterstützt wird, gibt dieser Aufruf HRESULT_FROM_WIN32(ERROR_NOT_SUPPORTED) zurück.
SetRegisterMode ist asynchron und wird sofort zurückgegeben. Wenn kein Fehler auftritt, ruft der Mobile Broadband-Dienst nach Abschluss des Vorgangs die OnSetRegisterModeComplete-Methode von IMbnRegistrationEvents auf.
Anforderungen
| Unterstützte Mindestversion (Client) | Windows 7 [Desktop-Apps | UWP-Apps] |
| Unterstützte Mindestversion (Server) | Nicht unterstützt |
| Zielplattform | Windows |
| Kopfzeile | mbnapi.h |