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

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

  • Статья

Функция 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