Método IMbnConnectionProfileManager::GetConnectionProfiles (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 perfiles de conexión asociados al dispositivo.
Sintaxis
HRESULT GetConnectionProfiles(
[in] IMbnInterface *mbnInterface,
[out, retval] SAFEARRAY **connectionProfiles
);
Parámetros
[in] mbnInterface
IMbnInterface que representa el dispositivo para el que se aplica la solicitud de perfil. Si es NULL, la función devolverá todos los perfiles que están presentes en el sistema.
[out, retval] connectionProfiles
Matriz de interfaces IMbnConnectionProfile que representan todos los perfiles de conexión disponibles para el dispositivo. Si este método devuelve algo distinto de S_OK, el puntero de matriz 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 |
---|---|
|
El método se completó correctamente. |
|
La interfaz no es válida, lo más probable es que el dispositivo de banda ancha móvil se haya quitado del sistema. |
|
El dispositivo no está listo. No se puede obtener el identificador de suscriptor porque el dispositivo no está MBN_READY_STATE_INITIALIZED. |
|
El servicio de banda ancha móvil no se está ejecutando en este sistema. |
Comentarios
Cuando se llama a esta operación para un dispositivo determinado, devuelve una lista de perfiles que tienen el mismo identificador de suscriptor que el dispositivo notifica actualmente. El método GetSubscriberInformation de IMbnInterface se puede usar para obtener el identificador de suscriptor asociado a la interfaz.
Un perfil de conexión está asociado al identificador de suscriptor del dispositivo. En el caso de los dispositivos GSM, el identificador de suscriptor es la identidad de suscriptor móvil internacional (IMSI) de la SIM. En el caso de los dispositivos ICODE, es la cadena Número de identificación móvil (MIN) o la cadena International Roaming MIN (IRM).
Requisitos
Cliente mínimo compatible | Windows 7 [solo aplicaciones de escritorio] |
Servidor mínimo compatible | No se admite ninguno |
Plataforma de destino | Windows |
Encabezado | mbnapi.h |