Поделиться через

Метод IMbnConnectionProfileManager::CreateConnectionProfile (mbnapi.h)

  • Статья

Важно!

Начиная с Windows 10 версии 1803 API Win32, описанные в этом разделе, заменяются API среда выполнения Windows в пространстве имен Windows.Networking.Connectivity.

Создает новый профиль подключения для устройства.

Синтаксис

HRESULT CreateConnectionProfile(
  [in] LPCWSTR xmlProfile
);

Параметры

[in] xmlProfile

Строка со значением NULL, содержащая данные профиля в формате XML, соответствующий справочнику по схеме профилей мобильной широкополосной связи.

Возвращаемое значение

Этот метод может возвращать одно из этих значений.

Код возврата Описание
S_OK
 Метод завершился успешно.
HRESULT_FROM_WIN32(ERROR_ALREADY_EXISTS)
 Профиль с заданным именем уже существует.
E_MBN_INVALID_PROFILE
 Профиль не соответствует схеме профиля мобильного широкополосного подключения.
HRESULT_FROM_WIN32(ERROR_FILE_NOT_FOUND)
 Расположение файла значка, переданного в профиле, является недопустимым или недоступным.
E_MBN_DEFAULT_PROFILE_EXIST
 Вызывающее приложение указало флаг профиля по умолчанию в XML-данных, однако профиль по умолчанию уже существует для мобильного широкополосного устройства.

Комментарии

Это синхронная операция. Если этот вызов функции выполнен успешно, будет создан новый профиль, а служба мобильной широкополосной связи вызовет метод OnConnectionProfileArrival интерфейса IMbnConnectionProfileManagerEvents .

Если расположение файла значка указано в данных профиля, служба мобильной широкополосной связи скопирует файл значка из указанного расположения в собственном хранилище. Последующий запрос к объекту IMbnConnectionProfile для расположения файла значка вернет расположение файла, в котором служба мобильной широкополосной связи сохранила файл значка. Каждый раз, когда профиль удаляется из системы, его файл значка также удаляется из системы. Файл значка должен быть в формате BMP с размерами 32 x 32 пикселя.

Требования

   
Минимальная версия клиента Windows 7 [только классические приложения]
Минимальная версия сервера Ни одна версия не поддерживается
Целевая платформа Windows
Header mbnapi.h

См. также раздел

IMbnConnectionProfileManager