Метод IDot11AdHocManager::CommitCreatedNetwork (adhoc.h)

Статья
08/22/2023

Инициализирует созданную сеть и при необходимости фиксирует профиль сети в хранилище профилей. Сеть должна быть создана с помощью CreateNetwork перед вызовом CommitCreatedNetwork.

Синтаксис

HRESULT CommitCreatedNetwork(
  [in] IDot11AdHocNetwork *pIAdHoc,
  [in] BOOLEAN            fSaveProfile,
  [in] BOOLEAN            fMakeSavedProfileUserSpecific
);

Параметры

[in] pIAdHoc

Указатель на интерфейс IDot11AdHocNetwork , указывающий сеть для инициализации и фиксации.

[in] fSaveProfile

Необязательный параметр, указывающий, следует ли сохранять профиль беспроводной сети. Если задано значение TRUE, профиль сохраняется в хранилище профилей. После сохранения профиля пользователь может изменить его с помощью пользовательского интерфейса Управление беспроводной сетью . Профили также можно изменять с помощью собственных функций Wi-Fi.

Сохранение профиля изменяет сетевую подпись, возвращенную IDot11AdHocNetwork::GetSignature.

[in] fMakeSavedProfileUserSpecific

Необязательный параметр, указывающий, является ли сохраняемый профиль профилем всех пользователей. Если задано значение TRUE, профиль относится к текущему пользователю. Если задано значение FALSE, профиль является профилем всех пользователей, и его может использовать любой пользователь, выполнивший вход на компьютер. Этот параметр игнорируется, если fSaveProfile имеет значение FALSE.

По умолчанию только члены группы Администраторы могут сохранять профиль всех пользователей. Эти параметры безопасности можно изменить с помощью функции WlanSetSecuritySettings . Приложение должно быть запущено пользователем с достаточными привилегиями для успешного сохранения профиля всех пользователей.

Если приложение выполняется в окне удаленного рабочего стола, можно сохранить только профиль всех пользователей. Профили пользователей не могут быть сохранены в удаленном приложении.

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

Возможные возвращаемые значения включают, помимо прочего, следующие.

Код возврата	Описание
S_OK	Метод завершился успешно.
E_FAIL	Сбой метода.
E_INVALIDARG	Один из параметров является недопустимым.
E_NOINTERFACE	Указанный интерфейс не поддерживается.
E_OUTOFMEMORY	Методу не удалось выделить память, необходимую для выполнения этой операции.
E_POINTER	Недопустимый указатель, переданный в качестве параметра.

Требования

Требование	Значение
Минимальная версия клиента	Windows Vista [только классические приложения]
Минимальная версия сервера	Windows Server 2008 [только классические приложения]
Целевая платформа	Windows
Header	adhoc.h

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

IDot11AdHocManager

IDot11AdHocManager::CreateNetwork

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