Método IMbnConnectionProfileManager::CreateConnectionProfile (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.
Crea un nuevo perfil de conexión para el dispositivo.
Sintaxis
HRESULT CreateConnectionProfile(
[in] LPCWSTR xmlProfile
);
Parámetros
[in] xmlProfile
Cadena terminada en null que contiene los datos de perfil en formato XML compatibles con la referencia de esquema de perfil de banda ancha móvil.
Valor devuelto
Este método puede devolver uno de estos valores.
| Código devuelto | Descripción |
|---|---|
|
El método se completó correctamente. |
|
Ya existe un perfil con el nombre especificado. |
|
El perfil no se ajusta al esquema de perfil de banda ancha móvil. |
|
La ubicación del archivo de icono pasada en el perfil no es válida o no es accesible. |
|
La aplicación que llama especificó la marca de perfil predeterminada en los datos XML, pero el perfil predeterminado ya existe para el dispositivo de banda ancha móvil. |
Comentarios
Se trata de una operación sincrónica. Si esta llamada de función se realiza correctamente, se creará un nuevo perfil y el servicio de banda ancha móvil llamará al método OnConnectionProfileArrival de la interfaz IMbnConnectionProfileManagerEvents .
Si la ubicación del archivo de icono se especifica en los datos del perfil, el servicio de banda ancha móvil copiará el archivo de icono de la ubicación especificada en su propio almacén. Una consulta posterior en el objeto IMbnConnectionProfile de la ubicación del archivo de icono devolverá la ubicación del archivo donde el servicio Mobile Broadband almacenó el archivo de icono. Cada vez que se elimina un perfil del sistema, su archivo de icono también se elimina del sistema. El archivo de icono debe estar en el archivo de formato de archivo bmp con dimensiones de 32 x 32 píxeles.
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 |