IMbnPinEvents::OnChangeComplete method (mbnapi.h)

Notification method called by the Mobile Broadband service to indicate that a PIN change operation has completed.

Syntax

HRESULT OnChangeComplete(
  [in] IMbnPin      *Pin,
  [in] MBN_PIN_INFO *pinInfo,
  [in] ULONG        requestID,
  [in] HRESULT      status
);

Parameters

[in] Pin

An IMbnPin interface that represents the PIN type.

[in] pinInfo

A pointer to an MBN_PIN_INFO structure that contains information on remaining attempts, in case of failure operations. The contents of pinInfo are meaningful only when status is E_MBN_FAILURE.

[in] requestID

A request ID set by the Mobile Broadband service to identify the PIN change request.

[in] status

A status code that indicates the outcome of the PIN change operation.

A calling application can expect one of the following values.

Return value

This method must return S_OK.

Remarks

The OnChangeComplete method is called by the Mobile Broadband service to report the completion status of a PIN change operation initialized by a call to the Change method of IMbnPin.

The contents of pinInfo are meaningful only when status is E_MBN_FAILURE. The pinState member should be ignored and pinType field is set to the PIN type of the current IMbnPin interface. This structure contains the attempts remaining to enter a valid PIN.

For example, if the PIN passed to change a PIN type is incorrect then the operation will fail with a status code of E_MBN_FAILURE. In this case, pinInfo.attemptsRemaining specifies the number of attempts remaining to retry this operation. If repeated attempts with the wrong PIN causes attemptsRemaining to become 0 then the application can call the GetPinState method of IMbnPinManager to get the type of PIN required.

Requirements

See also

IMbnPinEvents