IMbnPinManager::GetPinState-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.

Ruft den aktuellen PIN-Status des Geräts ab.

Syntax

HRESULT GetPinState(
  [out] ULONG *requestID
);

Parameter

[out] requestID

Ein Zeiger auf die Anforderungs-ID, die vom Mobilen Breitbanddienst für diese asynchrone Anforderung festgelegt wird. Die Antwort enthält dieselbe Anforderungs-ID.

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

Hinweise

Die GetPinState-Methode initiiert eine asynchrone Anforderung für den PIN-Status des Geräts. Der PIN-Status gibt an, ob eine PIN eingegeben werden muss, damit ein angeforderter Vorgang abgeschlossen werden kann. Es enthält auch Informationen darüber, welche Art von PIN von einem Gerät erwartet wird, und gibt optional die Anzahl der verbleibenden Versuche für die Eingabe einer gültigen PIN an.

Diese Methode gibt immer den aktuellen PIN-Zustand des Geräts zurück. Der PIN-Status zum Zeitpunkt der Erstellung dieses Objekts wird nicht zwischengespeichert. Stattdessen kontaktiert er immer das Gerät und gibt den aktuellen PIN-Zustand des Geräts zurück.

Da es sich um einen asynchronen Vorgang handelt, wird GetPinState sofort zurückgegeben. Nach Abschluss des Vorgangs ruft der Mobile Broadband-Dienst die OnGetPinStateComplete-Methode von IMbnPinManagerEvents auf.

Wenn ein Vorgang E_MBN_PIN_REQUIRED zurückgibt oder der vom Gerät gemeldete Bereitzustand MBN_READY_STATE_DEVICE_LOCKED ist, sollte eine Anwendung diese Methode verwenden, um den Typ der PIN abzufragen, die zum Entsperren des Geräts oder der SIM erforderlich ist.

Während dieser Vorgang ausgeführt wird, ist ein Aufruf der OnGetPinStateComplete-Methode von IMbnPinManagerEvents nicht garantiert, wenn das Mobile Broadband-Gerät aus dem System entfernt wird.

Anforderungen

   
Unterstützte Mindestversion (Client) Windows 7 [Desktop-Apps | UWP-Apps]
Unterstützte Mindestversion (Server) Nicht unterstützt
Zielplattform Windows
Kopfzeile mbnapi.h

Weitere Informationen

IMbnPinManager