Метод IMbnConnectionProfileManager::CreateConnectionProfile (mbnapi.h)
Важно!
Начиная с Windows 10 версии 1803 API Win32, описанные в этом разделе, заменяются API среда выполнения Windows в пространстве имен Windows.Networking.Connectivity.
Создает новый профиль подключения для устройства.
Синтаксис
HRESULT CreateConnectionProfile(
[in] LPCWSTR xmlProfile
);
Параметры
[in] xmlProfile
Строка со значением NULL, содержащая данные профиля в формате XML, соответствующий справочнику по схеме профилей мобильной широкополосной связи.
Возвращаемое значение
Этот метод может возвращать одно из этих значений.
| Код возврата | Описание |
|---|---|
|
Метод завершился успешно. |
|
Профиль с заданным именем уже существует. |
|
Профиль не соответствует схеме профиля мобильного широкополосного подключения. |
|
Расположение файла значка, переданного в профиле, является недопустимым или недоступным. |
|
Вызывающее приложение указало флаг профиля по умолчанию в XML-данных, однако профиль по умолчанию уже существует для мобильного широкополосного устройства. |
Комментарии
Это синхронная операция. Если этот вызов функции выполнен успешно, будет создан новый профиль, а служба мобильной широкополосной связи вызовет метод OnConnectionProfileArrival интерфейса IMbnConnectionProfileManagerEvents .
Если расположение файла значка указано в данных профиля, служба мобильной широкополосной связи скопирует файл значка из указанного расположения в собственном хранилище. Последующий запрос к объекту IMbnConnectionProfile для расположения файла значка вернет расположение файла, в котором служба мобильной широкополосной связи сохранила файл значка. Каждый раз, когда профиль удаляется из системы, его файл значка также удаляется из системы. Файл значка должен быть в формате BMP с размерами 32 x 32 пикселя.
Требования
| Минимальная версия клиента | Windows 7 [только классические приложения] |
| Минимальная версия сервера | Ни одна версия не поддерживается |
| Целевая платформа | Windows |
| Header | mbnapi.h |