Função WlanSaveTemporaryProfile (wlanapi.h)
A função WlanSaveTemporaryProfile salva um perfil temporário no repositório de perfil.
Sintaxe
DWORD WlanSaveTemporaryProfile(
[in] HANDLE hClientHandle,
[in] const GUID *pInterfaceGuid,
[in] LPCWSTR strProfileName,
[in, optional] LPCWSTR strAllUserProfileSecurity,
[in] DWORD dwFlags,
[in] BOOL bOverWrite,
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] strProfileName
O nome do perfil a ser salvo. Os nomes de perfil diferenciam maiúsculas de minúsculas. Essa cadeia de caracteres deve ser terminada em NULL.
[in, optional] strAllUserProfileSecurity
Define a cadeia de caracteres do descritor de segurança no perfil de todos os usuários. Por padrão, para um novo perfil de todos os usuários, todos os usuários têm acesso de gravação no perfil. Para obter mais informações sobre permissões de perfil, consulte a seção Comentários.
Se dwFlags estiver definido como WLAN_PROFILE_USER, esse parâmetro será ignorado.
Se esse parâmetro for definido como NULL para um perfil de todos os usuários, as permissões padrão serão usadas.
Se esse parâmetro não for NULL para um perfil de todos os usuários, a cadeia de caracteres do descritor de segurança associada ao perfil será criada ou modificada depois que o objeto descritor de segurança for criado e analisado como uma cadeia de caracteres.
[in] dwFlags
Especifica os sinalizadores a serem definidos no perfil. Os sinalizadores podem ser combinados.
[in] bOverWrite
Especifica se esse perfil está substituindo um perfil existente. Se esse parâmetro for FALSE e o perfil já existir, o perfil existente não será substituído e um erro será retornado.
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 |
|---|---|
|
Uma das seguintes condições ocorreu:
|
|
O identificador hClientHandle não foi encontrado na tabela de identificador. |
|
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. |
|
Vários códigos de erro. |
|
No momento, a interface não está conectada usando um perfil temporário. |
Comentários
Um perfil temporário é aquele passado para WlanConnect ou gerado pelo mecanismo de descoberta. Uma conexão de rede pode ser estabelecida usando um perfil temporário. O uso dessa API salva o perfil temporário e os dados do usuário associados ao repositório de perfil.
Um novo perfil é adicionado na parte superior da lista após os perfis de política de grupo. A posição de um perfil na lista não será alterada se um perfil existente for substituído.
Os perfis de todos os usuários têm três permissões associadas: leitura, gravação e execução. Se um usuário tiver acesso de leitura, o usuário poderá exibir permissões de perfil. Se um usuário tiver acesso de execução, o usuário terá acesso de leitura e o usuário também poderá se conectar e desconectar de uma rede usando o perfil. Se um usuário tiver acesso de gravação, o usuário terá acesso de execução e o usuário também poderá modificar e excluir permissões associadas a um perfil.
A seguir, descreve o procedimento para criar um objeto descritor de segurança e analisá-lo como uma cadeia de caracteres.
- Chame InitializeSecurityDescriptor para criar um descritor de segurança na memória.
- Chame SetSecurityDescriptorOwner.
- Chame InitializeAcl para criar uma DACL (lista de controle de acesso discricionário) na memória.
- 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
- Chame SetSecurityDescriptorDacl para adicionar a DACL ao descritor de segurança.
- Chame ConvertSecurityDescriptorToStringSecurityDescriptor para converter o descritor em cadeia de caracteres.
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 |