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.
Ruft den aktuellen Verbindungsstatus des Geräts ab.
Syntax
HRESULT GetConnectionState(
[out, retval] MBN_ACTIVATION_STATE *ConnectionState,
[out, retval] BSTR *ProfileName
);
Parameter
[out, retval] ConnectionState
Ein Zeiger auf eine MBN_ACTIVATION_STATE-Struktur , die den Zustand der Verbindung enthält.
[out, retval] ProfileName
Ein Zeiger auf eine Zeichenfolge, die den Namen des Verbindungsprofils enthält. Dieser Parameter ist nur gültig, wenn ConnectionStateMBN_ACTIVATION_STATE_ACTIVATED ist. Wenn diese Zeichenfolge nicht NULL ist, muss die aufrufende Anwendung diese Zeichenfolge durch Aufrufen von SysFreeString freigeben.
Rückgabewert
Diese Methode kann einen dieser Werte zurückgeben.
| Rückgabecode | BESCHREIBUNG |
|---|---|
|
Die Methode wurde erfolgreich abgeschlossen.
Hinweis Diese Methode kann S_OK zurückgeben, wenn ProfileNameNULL ist. Stellen Sie sicher, dass Ihr Client einen NULL-Profilnamen auch dann verarbeiten kann, wenn der Aufruf erfolgreich ist.
|
|
Der Aktivierungsstatus ist nicht verfügbar. Der Mobile Broadband-Dienst überprüft das Gerät nach den Informationen. Die aufrufende Anwendung kann benachrichtigt werden, wenn der Aktivierungsstatus verfügbar ist, indem sie sich für die OnConnectStateChange-Methode von IMbnConnectionEvents registriert. |
|
Zum Abrufen des Anrufstatus ist eine PIN erforderlich. |
|
Eine SIM-Karte ist nicht in das Gerät eingefügt. |
|
Eine ungültige SIM-Karte wird in das Gerät eingefügt. |
Hinweise
Diese Methode kann S_OK zurückgeben, wenn ProfileNameNULL ist. Stellen Sie sicher, dass Ihr Client einen NULL-Profilnamen auch dann verarbeiten kann, wenn der Aufruf erfolgreich ist.
Anforderungen
| Unterstützte Mindestversion (Client) | Windows 7 [Desktop-Apps | UWP-Apps] |
| Unterstützte Mindestversion (Server) | Nicht unterstützt |
| Zielplattform | Windows |
| Kopfzeile | mbnapi.h |