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
S_OK	El método se completó correctamente.
E_HANDLE	La interfaz no es válida, lo más probable es que el dispositivo de banda ancha móvil se haya quitado del sistema.
HRESULT_FROM_WIN32(ERROR_NOT_READY)	El dispositivo no está listo. No se puede obtener el identificador de suscriptor porque el dispositivo no está MBN_READY_STATE_INITIALIZED.
HRESULT_FROM_WIN32(ERROR_SERVICE_NOT_ACTIVE)	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

Consulte también

IMbnConnectionProfileManager