The topic you requested is included in another documentation set. For convenience, it's displayed below. Choose Switch to see the topic in its original location.

IMbnPinManager::GetPinList method

Gets a list of different PIN types supported by the device.

Syntax

C++


HRESULT GetPinList(
  [out, retval] SAFEARRAY(IMbnPin*) *pinList
);

Parameters

pinList [out, retval]: A pointer to a list of MBN_PIN_TYPE values that represent the PIN types supported by the device. When GetPinList returns anything other than S_OK, pinList is NULL, otherwise the calling application must free the allocated memory by calling SafeArrayDestroy.

Return value

This method can return one of these values.

Return code	Description
S_OK	The method completed successfully.
E_PENDING	The PIN types are not available. The Mobile Broadband service is currently probing the device to get the information. When the PIN types are available, the Mobile Broadband service will call the OnPinListAvailable method of IMbnPinManagerEvents.
E_MBN_PIN_REQUIRED	The device requires that a PIN must be entered for this operation.
E_MBN_SIM_NOT_INSERTED	The SIM is not inserted.
E_MBN_BAD_SIM	A bad SIM is inserted in the device.

Remarks

On the recoverable errors E_MBN_PIN_REQUIRED, E_MBN_SIM_NOT_INSERTED, and E_MBN_BAD_SIM, the Mobile Broadband service will attempt to retrieve this information from the device when the error condition is over. While it is retrieving this information GetPinList call will return E_PENDING. Once the retrieval operation is complete, the Mobile Broadband service will call the OnPinListAvailable method of IMbnPinManagerEvents.

Requirements

Minimum supported client	Windows 7 [desktop apps \| Windows Store apps]
Minimum supported server	None supported
IDL	Mbnapi.idl