Compartir a través de

Método IMbnInterface::GetSubscriberInformation (mbnapi.h)

  • Artículo

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 la información del suscriptor.

Sintaxis

HRESULT GetSubscriberInformation(
  [out, retval] IMbnSubscriberInformation **subscriberInformation
);

Parámetros

[out, retval] subscriberInformation

Puntero a la dirección de una interfaz IMbnSubscriberInformation que contiene información de suscriptor para el dispositivo. Si este método devuelve cualquier valor distinto de S_OK, este parámetro es NULL.

Valor devuelto

Este método puede devolver uno de estos valores.

Código devuelto Descripción
S_OK
 El método se completó correctamente. subscriberInformation contiene una interfaz válida.
E_PENDING
 La información no está disponible. Actualmente, el servicio de banda ancha móvil está sondeando la información. La aplicación que realiza la llamada puede recibir notificaciones cuando la información está disponible registrando para el método OnSubscriberInformationChange de IMbnInterfaceEvents.

Comentarios

El método GetSubscriberInformation devuelve la información relacionada con el suscriptor, incluido el identificador de suscriptor, el número de tarjeta de circuito internacional sim y los números de teléfono asociados a esta interfaz.

Cuando se llama a este método desde una aplicación de la Tienda Windows con privilegios de operador de telefonía móvil, solo devolverá el número de tarjeta de circuito INTERNACIONAL sim definido por la propiedad SimIccID .

Algunos de los valores devueltos en la información del suscriptor solo se rellenan cuando el estado listo que notifica el método GetReadyState de IMbnInterface es MBN_READY_STATE_INITIALIZED. Cada vez que se produzca un cambio en la información del suscriptor asociada al dispositivo de banda ancha móvil, el servicio de banda ancha móvil notificará a las aplicaciones registradas llamando al método OnSubscriberInformationChange de IMbnInterfaceEvents.

La información del suscriptor de un dispositivo no cambiará una vez que se MBN_READY_STATE_INITIALIZED el estado listo del dispositivo.

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

IMbnInterface