Edit

Share via

MBN_PIN_INFO structure (mbnapi.h)

  • Article

Important

Starting in Windows 10, version 1803, the Win32 APIs described in this section are replaced by the Windows Runtime APIs in the Windows.Networking.Connectivity namespace.

The MBN_PIN_INFO structure represents the current PIN state of the device. It indicates if some PIN is expected by the device and the PIN type expected. Optionally, it also conveys remaining allowed attempts to enter a valid PIN. This structure can be obtained by either calling the GetPinState method of IMbnPinManager or supplied as an input parameter to the OnEnterComplete method of IMbnPinEvents.

Syntax

typedef struct MBN_PIN_INFO {
  MBN_PIN_STATE pinState;
  MBN_PIN_TYPE  pinType;
  ULONG         attemptsRemaining;
} MBN_PIN_INFO;

Members

pinState

An MBN_PIN_STATE value that indicates the current PIN state of the device.

pinType

An MBN_PIN_TYPE value that indicates the type of PIN expected. This field is valid only when pinState is either MBN_PIN_STATE_ENTER or MBN_PIN_STATE_UNBLOCK.

attemptsRemaining

Contains the number of attempts remaining to enter the valid PIN. This information is not available on some devices. If it is not available, then it is set to MBN_ATTEMPTS_REMAINING_UNKNOWN.

Requirements

Requirement Value
Minimum supported client Windows 7 [desktop apps | UWP apps]
Minimum supported server None supported
Header mbnapi.h