Função WlanRenameProfile (wlanapi.h)

Artigo
08/28/2023

A função WlanRenameProfile renomeia o perfil especificado.

Sintaxe

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

Parâmetros

[in] hClientHandle

O identificador de sessão do cliente, obtido por uma chamada anterior para a função WlanOpenHandle .

[in] pInterfaceGuid

O GUID da interface.

[in] strOldProfileName

O nome do perfil a ser alterado.

[in] strNewProfileName

O novo nome do perfil.

pReserved

Reservado para uso futuro. Deve ser definido como NULL.

Valor retornado

Se a função obtiver êxito, o valor retornado será ERROR_SUCCESS.

Se a função falhar, o valor retornado poderá ser um dos seguintes códigos de retorno.

Código de retorno	Descrição
PARÂMETRO ERROR_INVALID	hClientHandle é NULL ou não é válido, pInterfaceGuid é NULL, strOldProfileName é NULL, strNewProfileName é NULL ou pReserved não é NULL.
ERROR_INVALID_HANDLE	O identificador hClientHandle não foi encontrado na tabela de identificadores.
ERROR_NOT_FOUND	O perfil especificado por strOldProfileName não foi encontrado no repositório de perfis.
ERROR_ACCESS_DENIED	O chamador não tem permissões suficientes para renomear o perfil.
ERROR_NOT_SUPPORTED	Essa função foi chamada de uma plataforma sem suporte. Esse valor será retornado se essa função for chamada de um Windows XP com SP3 ou API lan sem fio para Windows XP com cliente SP2.
RPC_STATUS	Vários códigos de erro.

Requisitos


Cliente mínimo com suporte	Windows Vista [somente aplicativos da área de trabalho]
Servidor mínimo com suporte	Windows Server 2008 [somente aplicativos da área de trabalho]
Plataforma de Destino	Windows
Cabeçalho	wlanapi.h (inclua Wlanapi.h)
Biblioteca	Wlanapi.lib
DLL	Wlanapi.dll

Confira também

WlanDeleteProfile

WlanGetProfile

WlanSetProfile

Compartilhar via