Método IMbnInterface::GetSubscriberInformation (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 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 |
|---|---|
|
El método se completó correctamente. subscriberInformation contiene una interfaz válida. |
|
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 |