MBN_PIN_INFO structure (mbnapi.h)


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.


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



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


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.


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.


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