Função WlanGetSecuritySettings (wlanapi.h)

  • Artigo

A função WlanGetSecuritySettings obtém as configurações de segurança associadas a um objeto configurável.

Sintaxe

DWORD WlanGetSecuritySettings(
  [in]            HANDLE                  hClientHandle,
  [in]            WLAN_SECURABLE_OBJECT   SecurableObject,
  [out, optional] PWLAN_OPCODE_VALUE_TYPE pValueType,
  [out]           LPWSTR                  *pstrCurrentSDDL,
  [out]           PDWORD                  pdwGrantedAccess
);

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 se aplicam.

[out, optional] pValueType

Um ponteiro para um valor WLAN_OPCODE_VALUE_TYPE que especifica a origem das configurações de segurança.

Valor Significado
wlan_opcode_value_type_set_by_group_policy
 As configurações de segurança foram definidas pela política de grupo.
wlan_opcode_value_type_set_by_user
 As configurações de segurança foram definidas pelo usuário. Um usuário pode definir configurações de segurança chamando WlanSetSecuritySettings.

[out] pstrCurrentSDDL

Na entrada, esse parâmetro deve ser NULL.

Na saída, esse parâmetro recebe um ponteiro para a cadeia de caracteres do descritor de segurança que especifica as configurações de segurança do objeto se a chamada de função for bem-sucedida. Para obter mais informações sobre essa cadeia de caracteres, consulte Função WlanSetSecuritySettings .

[out] pdwGrantedAccess

A máscara de acesso do objeto .

Valor Significado
WLAN_READ_ACCESS
 O chamador pode exibir as permissões do objeto.
WLAN_EXECUTE_ACCESS
 O chamador pode ler e executar o objeto . WLAN_EXECUTE_ACCESS tem o mesmo valor que a combinação OR bit a bit WLAN_READ_ACCESS | WLAN_EXECUTE_ACCESS.
WLAN_WRITE_ACCESS
 O chamador pode ler, executar e gravar no objeto. WLAN_WRITE_ACCESS tem o mesmo valor que a combinação OR bit a bit WLAN_READ_ACCESS | WLAN_EXECUTE_ACCESS | WLAN_WRITE_ACCESS.

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_INVALID_PARAMETER
 Um parâmetro está incorreto. Esse erro será retornado se alguma das seguintes condições ocorrer:
  • hClientHandle é NULL.
  • pstrCurrentSDDL é NULL.
  • pdwGrantedAccess é 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

O chamador é responsável por liberar a memória alocada para a cadeia de caracteres do descritor de segurança apontada pelo parâmetro pstrCurrentSDDL se a função for bem-sucedida. Quando não for mais necessário, a memória da cadeia de caracteres do descritor de segurança deverá ser liberada chamando a função WlanFreeMemory e passando o parâmetro pstrCurrentSDDL .

Requisitos

Requisito Valor
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

WlanFreeMemory

WlanSetSecuritySettings