Função WlanSetProfileList (wlanapi.h)

  • Artigo

A função WlanSetProfileList define a ordem de preferência de perfis para uma determinada interface.

Sintaxe

DWORD WlanSetProfileList(
  [in] HANDLE     hClientHandle,
  [in] const GUID *pInterfaceGuid,
  [in] DWORD      dwItems,
  [in] LPCWSTR    *strProfileNames,
       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] dwItems

O número de perfis no parâmetro strProfileNames .

[in] strProfileNames

Os nomes dos perfis na ordem desejada. Os nomes de perfil diferenciam maiúsculas de minúsculas. Essa cadeia de caracteres deve ser terminada em NULL.

Windows XP com SP3 e API lan sem fio para Windows XP com SP2: Os nomes fornecidos devem corresponder aos nomes de perfil derivados automaticamente do SSID da rede. Para perfis de rede de infraestrutura, o SSID deve ser fornecido para o nome do perfil. Para perfis de rede ad hoc, o nome fornecido deve ser o SSID da rede ad hoc seguido por -adhoc.

pReserved

Reservado para uso futuro. Deve ser definido como NULL.

Retornar valor

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
ERROR_ACCESS_DENIED
 O chamador não tem permissões suficientes para alterar a lista de perfis.

Antes de WlanSetProfileList executar uma operação que altera a ordem relativa de todos os perfis de usuário na lista de perfis ou move um perfil de todos os usuários para uma posição inferior na lista de perfis, WlanSetProfileList recupera a DACL (lista de controle de acesso discricionário) armazenada com o objeto wlan_secure_all_user_profiles_order . Se a DACL não contiver uma ACE (entrada de controle de acesso) que conceda permissão WLAN_WRITE_ACCESS ao token de acesso do thread de chamada, WlanSetProfileList retornará ERROR_ACCESS_DENIED.
ERROR_INVALID_HANDLE
 O identificador hClientHandle não foi encontrado na tabela de identificador.
ERROR_INVALID_PARAMETER
 Uma das seguintes condições ocorreu:
  • hClientHandle é NULL ou inválido.
  • pInterfaceGuid é NULL.
  • dwItems é 0.
  • strProfileNames é NULL.
  • O mesmo nome de perfil aparece mais de uma vez em strProfileNames.
  • pReserved não é NULL.
ERROR_NOT_FOUND
 strProfileNames contém o nome de um perfil que não está presente no repositório de perfil.
RPC_STATUS
 Vários códigos de erro.

Comentários

A função WlanSetProfileList define a ordem de preferência de perfis de LAN sem fio para uma determinada interface sem fio.

Os perfis na lista devem ser uma correspondência um-para-um com os perfis atuais retornados pela função WlanGetProfileList . A posição dos perfis de política de grupo não pode ser alterada.

Todas as funções lan sem fio exigem um GUID de interface para a interface sem fio ao executar operações de perfil. Quando uma interface sem fio é removida, seu estado é desmarcado do WLANSVC (Wireless LAN Service) e nenhuma operação de perfil é possível.

A função WlanSetProfileList poderá falhar com ERROR_INVALID_PARAMETER se a interface sem fio especificada no parâmetro pInterfaceGuid tiver sido removida do sistema (um adaptador sem fio USB que foi removido, por exemplo).

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows Vista, Windows XP com SP3 [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
Redistribuível API de LAN sem fio para Windows XP com SP2

Confira também

WlanGetProfile

WlanGetProfileList

WlanSetProfile