Freigeben über


IMbnPin::Unblock-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.

Hebt die Blockierung einer blockierten PIN auf.

Syntax

HRESULT Unblock(
  [in]  LPCWSTR puk,
  [in]  LPCWSTR newPin,
  [out] ULONG   *requestID
);

Parameter

[in] puk

Der PUK-Wert (Password Unblock Key) für diesen PIN-Typ.

[in] newPin

Eine neue PIN, die für diesen PIN-Typ festgelegt werden soll.

[out] requestID

Eine Anforderungs-ID, die vom Mobilen Breitbanddienst festgelegt wurde, um diese asynchrone Anforderung zu identifizieren.

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
Ungültige Schnittstelle. Das mobile Breitbandgerät wurde wahrscheinlich aus dem System entfernt.
HRESULT_FROM_WIN32(ERROR_NOT_FOUND)
Ungültige Schnittstelle. Höchstwahrscheinlich wurde das mobile Breitbandgerät aus dem System entfernt.
E_ACCESSDENIED
Diese Methode ist für das Aufrufen von Prozessberechtigungen nicht zulässig.

Hinweise

Die Unblock-Methode entsperrt die PIN für den Pintyp, indem sie den PUK eingibt, und legt eine neue PIN fest. Die PinType-Eigenschaft dieses IMbnPin stellt den Typ der PIN dar, der geändert wird.

Das ist ein asynchroner Vorgang. Wenn die Methode erfolgreich zurückgegeben wird, ruft der Mobile Broadband-Dienst nach Abschluss des Vorgangs die OnUnblockComplete-Methode von IMbnPinEvents auf.

Wenn die GetPinState-Methode von IMbnPinManager den aktuellen PIN-Status auf MBN_PIN_STATE_UNBLOCK festgelegt hat, sollte die Anwendung Unblock für den PIN-Typ verwenden, der in PinInfo.pinType zurückgegeben wird, das von der OnGetPinStateComplete-Methode von IMbnPinManagerEvents übergeben wird.

Für den Aufruf dieser Methode sind Administratorrechte erforderlich.

Anforderungen

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

Weitere Informationen

IMbnPin