IMbnPin::Change method

Changes the PIN.

Syntax


HRESULT Change(
  [in]  LPCWSTR pin,
  [in]  LPCWSTR newPin,
  [out] ULONG   *requestID
);

Parameters

pin [in]

The current PIN for this PIN type.

newPin [in]

The new PIN for this PIN type.

requestID [out]

A request ID set by the Mobile Broadband service to identify this asynchronous request.

Return value

This method can return one of these values.

Return codeDescription
S_OK

The method completed successfully.

HRESULT_FROM_WIN32(ERROR_SERVICE_NOT_ACTIVE)

The Mobile Broadband service is not running on this system.

E_HANDLE

Invalid interface. The Mobile Broadband device has probably been removed from the system.

HRESULT_FROM_WIN32(ERROR_NOT_FOUND)

Invalid interface. Most likely the Mobile Broadband device has been removed from the system.

 

Remarks

The Change method changes the PIN for the PIN type. The PinType property of this IMbnPin represents the type of PIN to be changed.

This is an asynchronous operation. If the method returns with success, then upon completion of the operation, the Mobile Broadband service will call the OnChangeComplete method of IMbnPinEvents

.

Requirements

Minimum supported client

Windows 7 [desktop apps | Windows Store apps]

Minimum supported server

None supported

IDL

Mbnapi.idl

See also

IMbnPin

 

 

Show: