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

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

Freigeben über