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
S_OK	El método se completó correctamente.
HRESULT_FROM_WIN32(ERROR_ALREADY_EXISTS)	Ya existe un perfil con el nombre especificado.
E_MBN_INVALID_PROFILE	El perfil no se ajusta al esquema de perfil de banda ancha móvil.
HRESULT_FROM_WIN32(ERROR_FILE_NOT_FOUND)	La ubicación del archivo de icono pasada en el perfil no es válida o no es accesible.
E_MBN_DEFAULT_PROFILE_EXIST	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

Consulte también

IMbnConnectionProfileManager