IMbnPin::Unblock メソッド (mbnapi.h)

重要

バージョン 1803 Windows 10以降、このセクションで説明する Win32 API は、Windows.Networking.Connectivity 名前空間のWindows ランタイム API に置き換えられます。

ブロックされた PIN のブロックを解除します。

構文

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

パラメーター

[in] puk

この PIN の種類のパスワード ブロック解除キー (PUK) の値。

[in] newPin

この PIN の種類に設定する新しい PIN。

[out] requestID

この非同期要求を識別するためにモバイル ブロードバンド サービスによって設定された要求 ID。

戻り値

このメソッドは、これらの値のいずれかを返すことができます。

リターン コード	説明
S_OK	メソッドは正常に完了しました。
HRESULT_FROM_WIN32(ERROR_SERVICE_NOT_ACTIVE)	モバイル ブロードバンド サービスがこのシステムで実行されていません。
E_HANDLE	インターフェイスが無効です。 モバイル ブロードバンド デバイスは、おそらくシステムから削除されています。
HRESULT_FROM_WIN32(ERROR_NOT_FOUND)	インターフェイスが無効です。 ほとんどの場合、モバイル ブロードバンド デバイスはシステムから削除されています。
E_ACCESSDENIED	このメソッドは、プロセス特権の呼び出しには使用できません。

注釈

ブロック解除メソッドは、PUK を入力してピンの種類の PIN のブロックを解除し、新しい PIN を設定します。 この IMbnPin の PinType プロパティは、変更される PIN の種類を表します。

これは非同期操作です。 メソッドが成功した場合、操作が完了すると、モバイル ブロードバンド サービスは IMbnPinEvents の OnUnblockComplete メソッドを呼び出します。

IMbnPinManager の GetPinState メソッドで現在の PIN 状態がMBN_PIN_STATE_UNBLOCKに設定されるたびに、アプリケーションは PIN の種類に対してブロック解除を使用する必要があります。これは、IMbnPinManagerEvents の OnGetPinStateComplete メソッドによって渡される PinInfo.pinType で返されます。

このメソッドを呼び出す場合は、管理者特権が必要です。

要件

要件	値
サポートされている最小のクライアント	Windows 7 [デスクトップ アプリ |UWP アプリ]
サポートされている最小のサーバー	サポートなし
対象プラットフォーム	Windows
ヘッダー	mbnapi.h

こちらもご覧ください

IMbnPin