IMbnPinManagerEvents::OnGetPinStateComplete-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 den Abschluss eines asynchronen Vorgangs anzugeben, der durch einen Aufruf der GetPinState-Methode von IMbnPinManager ausgelöst wird.

Syntax

HRESULT OnGetPinStateComplete(
  [in] IMbnPinManager *pinManager,
  [in] MBN_PIN_INFO   pinInfo,
  [in] ULONG          requestID,
  [in] HRESULT        status
);

Parameter

[in] pinManager

Zeiger auf eine IMbnPinManager-Schnittstelle , die das mobile Breitbandgerät darstellt, für das der Vorgang ausgeführt wurde.

[in] pinInfo

Eine MBN_PIN_INFO-Struktur , die die Geräte-PIN-Informationen enthält.

Wenn pinInfo.pinState auf MBN_PIN_STATE_NONE festgelegt ist, wird erwartet, dass keine PIN vom Gerät eingegeben wird.

Wenn pinInfo.pinState auf MBN_PIN_STATE_ENTER festgelegt ist, erwartet das Gerät, dass eine PIN eingegeben wird, und pinInfo.pinType stellt den typ der vom Gerät erwarteten PIN dar.

Wenn pinInfo.pinState auf MBN_PIN_STATE_UNBLOCK festgelegt ist, wird das Gerät mit der PIN blockiert, und es sollte versucht werden, die Blockierung der PIN aufzuheben. In diesem Fall stellt pinInfo.pinType den PIN-Typ dar, für den der Entsperrungsvorgang ausgeführt werden soll.

Wenn pinInfo.pinState auf MBN_PIN_STATE_ENTER oder MBN_PIN_STATE_UNBLOCK festgelegt ist, enthält pinInfo.attemptsRemaining die Anzahl der verbleibenden Versuche, eine gültige PIN oder pin unblock Key (PUK) einzugeben. Wenn die Anzahl der verbleibenden Versuche unbekannt ist, wird pinInfo.attemptsRemaining auf MBN_ATTEMPTS_REMAINING_UNKNOWN festgelegt.

[in] requestID

Die Anforderungs-ID, die vom Mobilen Breitbanddienst zugewiesen wird, um diesen Vorgang zu identifizieren.

[in] status

Der Vorgangsabschluss status.

Eine aufrufende Anwendung kann einen der folgenden Werte erwarten.

Wert	Bedeutung
S_OK	Der Vorgang wurde durchgeführt.
HRESULT_FROM_WIN32(ERROR_NOT_SUPPORTED)	Das Gerät unterstützt keine PIN-Vorgänge.
E_MBN_SIM_NOT_INSERTED	Der Vorgang konnte nicht abgeschlossen werden, da sich keine SIM-Karte im Gerät befindet.
E_MBN_BAD_SIM	Der Vorgang konnte nicht abgeschlossen werden, weil eine ungültige SIM-Karte auf dem Gerät erkannt wurde.

Rückgabewert

Diese Methode muss S_OK zurückgeben.

Hinweise

Diese Methode wird vom Mobilen Breitbanddienst aufgerufen, um eine Anwendung über den Abschluss eines asynchronen Vorgangs zu benachrichtigen, der durch einen Aufruf der GetPinState-Methode von IMbnPinManager ausgelöst wird.
Nach erfolgreichem Abschluss enthält pinInfo Informationen zur PIN, die als nächstes vom Gerät erwartet 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

IMbnPinManagerEvents

Freigeben über