Функция WlanRenameProfile (wlanapi.h)

Статья
08/28/2023

Функция WlanRenameProfile переименовывает указанный профиль.

Синтаксис

DWORD WlanRenameProfile(
  [in] HANDLE     hClientHandle,
  [in] const GUID *pInterfaceGuid,
  [in] LPCWSTR    strOldProfileName,
  [in] LPCWSTR    strNewProfileName,
       PVOID      pReserved
);

Параметры

[in] hClientHandle

Дескриптор сеанса клиента, полученный при предыдущем вызове функции WlanOpenHandle .

[in] pInterfaceGuid

Идентификатор GUID интерфейса.

[in] strOldProfileName

Имя профиля, который необходимо изменить.

[in] strNewProfileName

Новое имя профиля.

pReserved

Зарезервировано для последующего использования. Для параметра должно быть задано значение NULL.

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

Если функция выполняется успешно, возвращаемое значение будет ERROR_SUCCESS.

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

Код возврата	Описание
параметр ERROR_INVALID	hClientHandle имеет значение NULL или недопустимо, pInterfaceGuid — NULL, strOldProfileName — NULL, strNewProfileName — NULL или pReserved — не NULL.
ERROR_INVALID_HANDLE	Дескриптор hClientHandle не найден в таблице дескрипторов.
ERROR_NOT_FOUND	Профиль, указанный параметром strOldProfileName , не найден в хранилище профилей.
ERROR_ACCESS_DENIED	Вызывающий объект не имеет достаточных разрешений для переименования профиля.
ERROR_NOT_SUPPORTED	Эта функция была вызвана из неподдерживаемой платформы. Это значение будет возвращено, если эта функция была вызвана из клиента Windows XP с пакетом обновления 3 (SP3) или API беспроводной локальной сети для Windows XP с пакетом обновления 2 (SP2).
RPC_STATUS	Различные коды ошибок.

Требования


Минимальная версия клиента	Windows Vista [только классические приложения]
Минимальная версия сервера	Windows Server 2008 [только классические приложения]
Целевая платформа	Windows
Header	wlanapi.h (включая Wlanapi.h)
Библиотека	Wlanapi.lib
DLL	Wlanapi.dll

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

WlanDeleteProfile

WlanGetProfile

WlanSetProfile

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