Método IMbnConnectionProfileManager::GetConnectionProfile (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 un perfil de conexión específico asociado al dispositivo de banda ancha móvil especificado.

Sintaxis

HRESULT GetConnectionProfile(
  [in]          IMbnInterface         *mbnInterface,
  [in]          LPCWSTR               profileName,
  [out, retval] IMbnConnectionProfile **connectionProfile
);

Parámetros

[in] mbnInterface

IMbnInterface que representa el dispositivo para el que se aplica la solicitud de perfil. Si mbnInterface es NULL, esta función devolverá el perfil del nombre especificado asociado a cualquier dispositivo del sistema.

[in] profileName

Cadena terminada en null que contiene el nombre del perfil de conexión.

[out, retval] connectionProfile

Interfaz IMbnConnectionProfile que representa el perfil de conexión deseado. Si este método devuelve algo distinto de S_OK, 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.
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_FOUND)	No existe un perfil con el nombre especificado.
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_NOT_FOUND)	No existe un perfil con el nombre especificado.

Comentarios

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).

Si se ha creado un nuevo perfil mediante CreateConnectionProfile, el autor de la llamada debe esperar a que se reciba el evento OnConnectionProfileArrival antes de llamar a GetConnectionProfile con el nombre del nuevo perfil; De lo contrario, se puede producir un error en la llamada API GetConnectionProfilecon HRESULT_FROM_WIN32(ERROR_NOT_FOUND).

Requisitos

Requisito	Value
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