IMbnPinEvents::OnChangeComplete-Methode (mbnapi.h)

  • Artikel
  • 2 Minuten Lesedauer

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-Änderungsvorgang abgeschlossen ist.

Syntax

HRESULT OnChangeComplete(
  [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 Informationen zu verbleibenden Versuchen enthält, im Falle von Fehlervorgängen. Der Inhalt von pinInfo ist nur sinnvoll, wenn der StatusE_MBN_FAILURE ist.

[in] requestID

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

[in] status

Ein Statuscode, der das Ergebnis des PIN-Änderungsvorgangs 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)
 Das Gerät unterstützt diesen Vorgang nicht.
E_FAIL
 Der Vorgang konnte nicht abgeschlossen werden.
E_MBN_PIN_REQUIRED
 Für den Vorgang ist eine PIN erforderlich. Die aufrufende Anwendung kann die GetPinState-Methode von IMbnPinManager aufrufen, um den Typ der erwarteten PIN zu ermitteln.
E_MBN_SIM_NOT_INSERTED
 Es gibt keine SIM im Gerät.
E_MBN_BAD_SIM
 Es gibt eine schlechte SIM im Gerät.
E_MBN_PIN_DISABLED
 Der PIN-Änderungsvorgang wird für die deaktivierte PIN nicht unterstützt.

Rückgabewert

Diese Methode muss S_OK zurückgeben.

Bemerkungen

Die OnChangeComplete-Methode wird vom Mobilen Breitbanddienst aufgerufen, um den Abschlussstatus eines PIN-Änderungsvorgangs zu melden, der von einem Aufruf der Change-Methode von IMbnPin initialisiert wird.

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

Wenn beispielsweise die PIN, die an die Änderung eines PIN-Typs übergeben wurde, falsch ist, schlägt der Vorgang mit einem Statuscode von E_MBN_FAILURE fehl. In diesem Fall gibt pinInfo.attemptsRemaining die Anzahl der Versuche an, diese Operation erneut zu wiederholen. Wenn wiederholte Versuche mit der falschen PIN versuchenRemaining zu 0 werden, kann die Anwendung die GetPinState-Methode von IMbnPinManager aufrufen, um den erforderlichen PIN-Typ abzurufen.

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