Introducción a las API de Windows Runtime de banda ancha móvil
En la tabla siguiente se enumeran las API para crear una aplicación de banda ancha móvil.
| API | Descripción |
|---|---|
Proporciona información sobre el estado de conexión (por ejemplo, a Internet). |
|
Habilita extensiones específicas del dispositivo, como SIM Toolkit y descarga de lista de itinerancia preferida (PRL). |
|
Permite aprovisionar Windows con información de uso de datos y datos de aprovisionamiento de cuentas. |
|
Permite habilitar, deshabilitar o cambiar el PIN de SIM. |
|
Proporciona funciones necesarias para implementar un cliente SMS. |
|
Proporciona información de suscriptor para la SIM y la información del dispositivo de banda ancha móvil. |
|
Permite establecer una sesión de datos de servicio complementarios no estructurados (USSD) con una red (cliente y red iniciada). |
Las secciones siguientes están disponibles en este tema:
API de cuenta de banda ancha móvil
Dado que tiene métodos que se pueden usar para obtener información de identificación personal sobre el cliente y cambiar la configuración de red en dispositivos móviles de banda ancha, la API de cuenta de banda ancha móvil es una API con privilegios. Esto significa que la mayoría de las aplicaciones para UWP no pueden llamar a sus métodos sin obtener un error de "acceso denegado". Para poder llamar a esta API, una aplicación para UWP debe cumplir los siguientes criterios:
La aplicación debe tener un paquete de metadatos de dispositivo o de servicio asociado, y debe aparecer en el elemento XML PrivilegedApplications del archivo SoftwareInfo.xml dentro del paquete. El paquete no tiene que ser exclusivo de la aplicación; Es posible que cualquier aplicación para UWP determinada aparezca en el elemento PrivilegedApplications de varios paquetes. Ese paquete debe estar asociado al proveedor de servicios para un dispositivo de banda ancha móvil que haya estado activo al menos una vez en el equipo, de modo que se haya instalado.
El archivo appxmanifest de la aplicación necesita una <entrada DeviceCapability> para mobile Broadband Account API. Para ello, agregue el siguiente elemento XML como elemento secundario del <elemento Capabilities> en el archivo appxmanifest de la aplicación:
<DeviceCapability Name="BFCD56F7-3943-457F-A312-2E19BB6DC648" />Para obtener más información sobre el <elemento Capabilities>, vea Archivo de manifiesto de aplicación para Windows 8.
Nota Las aplicaciones que no son aplicaciones para UWP (por ejemplo, servicios de Microsoft Win32 o aplicaciones de escritorio) tienen acceso sin restricciones a la API de cuenta de banda ancha móvil. Esto se debe a que estas aplicaciones pueden usar las API existentes de Win32 y Component Object Model (COM) para obtener acceso completo a la red de banda ancha móvil. Estas API no se pueden usar desde aplicaciones para UWP.
Identificadores de cuenta de red
Un identificador de cuenta de red es un identificador único para una cuenta de banda ancha móvil. Proporciona un identificador unificado que se puede usar sin necesidad de saber si el identificador procede de una red GSM, FRAMEWORK o WiMAX. Windows genera identificadores de cuenta de red cada vez que encuentra un identificador de suscripción de red proporcionado por hardware que no se ha encontrado antes. En la lista siguiente se identifica el identificador de cuenta de red para cada tipo de red admitido:
Redes GSM: el ICCID de la SIM se usa para diferenciar entre suscripciones.
Redes ADVISOR: Se utiliza el número de identificación móvil (MIN).
Cuando Windows encuentra uno de los tipos de red anteriores por primera vez, crea un nuevo identificador de cuenta de red y lo asigna a un hash SHA-256 del identificador de suscripción proporcionado por hardware y, a continuación, almacena ambos en el registro. Por el contrario, si Windows encuentra el hash del identificador de suscripción proporcionado por hardware en el registro, usa el identificador de cuenta de red asociado a ese hash. Los identificadores de cuenta de red deben ser únicos globalmente (se basan en GUID), pero dado que lo que se almacena es un hash del identificador proporcionado por hardware, el hardware de red debe estar presente al intentar asignar un identificador de cuenta de red al ICCID o MIN desde el que se generó.
Importante Aunque obtener el ICCID de un identificador de cuenta de red requiere acceso al equipo y al dispositivo de red que se usan para asignarlos juntos, los identificadores de cuenta de red identifican de forma única a usuarios individuales. Por lo tanto, se recomienda seguir las directivas de su organización para tratar la información de identificación personal cuando trabaje con ellos.
Los identificadores de cuenta de red se separan mediante el operador de red móvil (MNO), por lo que si un usuario final tiene dispositivos de banda ancha móvil Provider1 y Provider2 y sus aplicaciones de banda ancha móvil correspondientes, la aplicación Provider1 no podrá usar ningún identificador de cuenta de red Provider2 y viceversa. La función que devuelve todos los identificadores de cuenta de red devolverá solo los identificadores de las cuentas de red para el MNO cuya aplicación llama a la función. Un intento de usar un identificador de cuenta de red que pertenezca a otro MNO producirá un error de "acceso denegado".
Nota Las aplicaciones que no son aplicaciones para UWP (por ejemplo, servicios Win32 o aplicaciones de escritorio) tienen acceso a todas las cuentas de red independientemente del proveedor de servicios de red.