Compartilhar via


Função WlanRenameProfile (wlanapi.h)

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