Método IMbnPinManager::GetPinList (mbnapi.h)

Importante

A partir de Windows 10, versión 1803, las API de Win32 descritas en esta sección se reemplazan por las API de Windows Runtime en el espacio de nombres Windows.Networking.Connectivity.

Obtiene una lista de diferentes tipos de PIN admitidos por el dispositivo.

Sintaxis

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

Parámetros

[out, retval] pinList

Puntero a una lista de MBN_PIN_TYPE valores que representan los tipos de PIN admitidos por el dispositivo. Cuando GetPinList devuelve algo distinto de S_OK, pinList es NULL; de lo contrario, la aplicación que realiza la llamada debe liberar la memoria asignada llamando a SafeArrayDestroy.

Valor devuelto

Este método puede devolver uno de estos valores.

Código devuelto	Descripción
S_OK	El método se completó correctamente.
E_PENDING	Los tipos de PIN no están disponibles. Actualmente, el servicio de banda ancha móvil está sondeando el dispositivo para obtener la información. Cuando los tipos de PIN estén disponibles, el servicio de banda ancha móvil llamará al método OnPinListAvailable de IMbnPinManagerEvents.
E_MBN_PIN_REQUIRED	El dispositivo requiere que se escriba un PIN para esta operación.
E_MBN_SIM_NOT_INSERTED	No se inserta la SIM.
E_MBN_BAD_SIM	Se inserta una SIM incorrecta en el dispositivo.

Comentarios

En los errores recuperables E_MBN_PIN_REQUIRED, E_MBN_SIM_NOT_INSERTED y E_MBN_BAD_SIM, el servicio de banda ancha móvil intentará recuperar esta información del dispositivo cuando finalice la condición de error. Mientras recupera esta información, la llamada a GetPinList devolverá E_PENDING. Una vez completada la operación de recuperación, el servicio de banda ancha móvil llamará al método OnPinListAvailable de IMbnPinManagerEvents.

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows 7 [aplicaciones de escritorio | Aplicaciones para UWP]
Servidor mínimo compatible	No se admite ninguno
Plataforma de destino	Windows
Encabezado	mbnapi.h

Consulte también

IMbnPinManager