IMbnPinEvents::OnUnblockComplete-Methode (mbnapi.h)

Artikel
08/24/2023

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.

Benachrichtigungsmethode, die vom mobilen Breitbanddienst aufgerufen wird, um anzugeben, dass ein Pin-Entsperrvorgang abgeschlossen wurde

Syntax

HRESULT OnUnblockComplete(
  [in] IMbnPin      *Pin,
  [in] MBN_PIN_INFO *pinInfo,
  [in] ULONG        requestID,
  [in] HRESULT      status
);

Parameter

[in] Pin

Eine IMbnPin-Schnittstelle , die den PIN-Typ darstellt.

[in] pinInfo

Ein Zeiger auf eine MBN_PIN_INFO-Struktur , die Im Falle von Fehlervorgängen Informationen zu verbleibenden Versuchen enthält. Der Inhalt von pinInfo ist nur dann sinnvoll, wenn statusE_MBN_FAILURE ist.

[in] requestID

Eine Anforderungs-ID, die vom Mobilen Breitbanddienst festgelegt wurde, um die PIN-Entsperrungsanforderung zu identifizieren.

[in] status

Ein status Code, der das Ergebnis des Vorgangs angibt.

Eine aufrufende Anwendung kann einen der folgenden Werte erwarten.

Wert	Bedeutung
S_OK	Der Vorgang wurde durchgeführt.
HRESULT_FROM_WIN32(ERROR_NOT_SUPPORTED)	Dieser Vorgang wird vom Gerät nicht unterstützt.
E_FAIL	Der Vorgang konnte nicht abgeschlossen werden.
E_MBN_PIN_REQUIRED	Eine PIN ist erforderlich, damit der Vorgang abgeschlossen werden kann. Die aufrufende Anwendung kann die GetPinState-Methode von IMbnPinManager aufrufen, um den Typ der erwarteten PIN zu ermitteln.
E_MBN_SIM_NOT_INSERTED	Es ist keine SIM-Karte im Gerät vorhanden.
E_MBN_BAD_SIM	Auf dem Gerät ist eine schlechte SIM-Karte vorhanden.

Rückgabewert

Diese Methode muss S_OK zurückgeben.

Hinweise

Die OnUnblockComplete-Methode wird vom Mobile Broadband-Dienst aufgerufen, um den Abschluss status eines Vorgangs zum Aufheben der Blockierung der PIN zu melden, der durch einen Aufruf der Unblock-Methode von IMbnPin initialisiert wird.

Der Inhalt von pinInfo ist nur dann sinnvoll, wenn statusE_MBN_FAILURE ist. Das pinState-Element sollte ignoriert werden, und das Feld pinType ist auf den PIN-Typ der aktuellen IMbnPin-Schnittstelle festgelegt. Diese Struktur enthält die verbleibenden Versuche, eine gültige PIN einzugeben.

Wenn die zum Ändern eines PIN-Typs übergebene PIN beispielsweise falsch ist, schlägt der Vorgang mit einem status Code von E_MBN_FAILURE fehl. In diesem Fall gibt pinInfo.attemptsRemaining die Anzahl der verbleibenden Versuche an, diesen Vorgang erneut auszuführen. Wenn wiederholte Versuche mit der falschen PIN dazu führen , dass versuchtRemaining zu 0 wird, kann die Anwendung die GetPinState-Methode von IMbnPinManager aufrufen, um den typ der erforderlichen PIN abzurufen.

Wenn das Gerät die Blockierung nicht aufheben kann und die PUK-Blockierung von einem MBN_PIN_TYPE_PIN1 Pin ist, führt dies auch dazu, dass sich der Bereitzustand des Geräts in MBN_READY_STATE_BAD_SIM ändert. Die aufrufende Anwendung wird über die ReadyState-Änderung über das OnReadyStateChange-Element von IMbnInterfaceEvents benachrichtigt.

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

IMbnPinEvents

Freigeben über