Função WlanSetSecuritySettings (wlanapi.h)

  • Artigo

A função WlanGetProfileList define as configurações de segurança para um objeto configurável.

Sintaxe

DWORD WlanSetSecuritySettings(
  [in] HANDLE                hClientHandle,
  [in] WLAN_SECURABLE_OBJECT SecurableObject,
  [in] LPCWSTR               strModifiedSDDL
);

Parâmetros

[in] hClientHandle

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

[in] SecurableObject

Um valor WLAN_SECURABLE_OBJECT que especifica o objeto ao qual as configurações de segurança serão aplicadas.

[in] strModifiedSDDL

Uma cadeia de caracteres de descritor de segurança que especifica as novas configurações de segurança do objeto. Essa cadeia de caracteres deve ser terminada em NULL. Para obter mais informações, consulte a seção Comentários.

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
ERROR_INVALID_PARAMETER
 Um parâmetro está incorreto. Esse erro será retornado se alguma das seguintes condições ocorrer:
  • hClientHandle é NULL.
  • strModifiedSDDL é NULL.
  • SecurableObject é definido como um valor maior ou igual a WLAN_SECURABLE_OBJECT_COUNT (12).
ERROR_INVALID_HANDLE
 Um identificador é inválido. Esse erro será retornado se o identificador especificado no parâmetro hClientHandle não tiver sido encontrado na tabela de identificador.
ERROR_ACCESS_DENIED
 O chamador não tem permissões suficientes.
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.

Comentários

Uma chamada bem-sucedida para a função WlanSetSecuritySettings substitui as permissões padrão associadas a um objeto . Para obter mais informações sobre permissões padrão, consulte Permissões de API wi-fi nativas.

A seguir, descreve o procedimento para criar um objeto descritor de segurança e analisá-lo como uma cadeia de caracteres.

  1. Chame InitializeSecurityDescriptor para criar um descritor de segurança na memória.
  2. Chame SetSecurityDescriptorOwner para definir as informações de proprietário para o descritor de segurança.
  3. Chame InitializeAcl para criar uma DACL (lista de controle de acesso discricionário) na memória.
  4. Chame AddAccessAllowedAce ou AddAccessDeniedAce para adicionar ACEs (entradas de controle de acesso) à DACL. Defina o parâmetro AccessMask como uma das seguintes combinações OR bit a bit, conforme apropriado:
    • WLAN_READ_ACCESS
    • WLAN_READ_ACCESS | WLAN_EXECUTE_ACCESS
    • WLAN_READ_ACCESS | WLAN_EXECUTE_ACCESS | WLAN_WRITE_ACCESS
  5. Chame SetSecurityDescriptorDacl para adicionar a DACL ao descritor de segurança.
  6. Chame ConvertSecurityDescriptorToStringSecurityDescriptor para converter o descritor em cadeia de caracteres.
A cadeia de caracteres retornada por ConvertSecurityDescriptorToStringSecurityDescriptor pode ser usada como o valor do parâmetro strModifiedSDDL ao chamar WlanSetSecuritySettings.

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

Permissões de API wi-fi nativas

WlanGetSecuritySettings