IMbnPinManagerEvents::OnGetPinStateComplete method (mbnapi.h)

Notification method called by the Mobile Broadband service to indicate the completion of an asynchronous operation triggered by a call to the GetPinState method of IMbnPinManager.

Syntax

HRESULT OnGetPinStateComplete(
  [in] IMbnPinManager *pinManager,
  [in] MBN_PIN_INFO   pinInfo,
  [in] ULONG          requestID,
  [in] HRESULT        status
);

Parameters

[in] pinManager

Pointer to an IMbnPinManager interface that represents the Mobile Broadband device for which the operation was performed.

[in] pinInfo

A MBN_PIN_INFO structure that contains the device PIN information.

If pinInfo.pinState is set to MBN_PIN_STATE_NONE then no PIN is expected to be entered by device.

If pinInfo.pinState is set to MBN_PIN_STATE_ENTER then the device is expecting a PIN to be entered and pinInfo.pinType represents the type of PIN expected by device.

If pinInfo.pinState is set to MBN_PIN_STATE_UNBLOCK then the device is PIN blocked and a PIN unblock operation should be tried to unblock the device. In this case, pinInfo.pinType represents the PIN type on which the unblock operation should be performed.

If pinInfo.pinState is set to MBN_PIN_STATE_ENTER or MBN_PIN_STATE_UNBLOCK, then pinInfo.attemptsRemaining contains the number of attempts remaining to enter a valid PIN or PIN unblock key (PUK). If the number of attempts remaining is unknown then pinInfo.attemptsRemaining is set to MBN_ATTEMPTS_REMAINING_UNKNOWN.

[in] requestID

The request ID assigned by the Mobile Broadband service to identify this operation.

[in] status

The operation completion status.

A calling application can expect one of the following values.

Return value

This method must return S_OK.

Remarks

This method is called by the Mobile Broadband service to notify an application of the completion of an asynchronous operation triggered by a call to the GetPinState method of IMbnPinManager.
On successful completion, pinInfo contains information about PIN next expected by the device.

Requirements

See also

IMbnPinManagerEvents