Método IDot11AdHocNetwork::Connect (adhoc.h)
Conecta-se a uma rede ad hoc sem fio criada anteriormente. Antes que um aplicativo possa se conectar a uma rede, a rede deve ter sido criada usando IDot11AdHocManager::CreateNetwork e confirmada usando IDot11AdHocManager::CommitCreatedNetwork.
Sintaxe
HRESULT Connect(
[in] LPCWSTR Passphrase,
[in] LONG GeographicalId,
[in] BOOLEAN fSaveProfile,
[in] BOOLEAN fMakeSavedProfileUserSpecific
);
Parâmetros
[in] Passphrase
A cadeia de caracteres de senha usada para autenticar o usuário ou o computador na rede.
O comprimento da cadeia de caracteres de senha depende das configurações de segurança passadas no parâmetro pSecurity da chamada CreateNetwork . A tabela a seguir mostra o comprimento da senha associado a várias configurações de segurança.
| Configurações de segurança | Comprimento da senha |
|---|---|
| Open-None | 0 |
| Open-WEP | 5 ou 13 caracteres; 10 ou 26 dígitos hexadecimal |
| WPA2PSK | 8 a 63 caracteres |
Para obter os valores enumerados que correspondem ao par de configurações de segurança acima, consulte DOT11_ADHOC_AUTH_ALGORITHM e DOT11_ADHOC_CIPHER_ALGORITHM.
[in] GeographicalId
A localização geográfica na qual a rede foi criada. Para obter uma lista de valores possíveis, consulte Tabela de Localizações Geográficas.
[in] fSaveProfile
Um parâmetro opcional que especifica se um perfil sem fio deve ser salvo. Se TRUE, o perfil será salvo no repositório de perfil. Depois que um perfil é salvo, o usuário pode modificar o perfil usando a interface do usuário Gerenciar Rede Sem Fio . Os perfis também podem ser modificados usando as funções wi-fi nativas.
Salvar um perfil modifica a assinatura de rede retornada por IDot11AdHocNetwork::GetSignature.
[in] fMakeSavedProfileUserSpecific
Um parâmetro opcional que especifica se o perfil a ser salvo é um perfil de todos os usuários. Se definido como TRUE, o perfil será específico para o usuário atual. Se definido como FALSE, o perfil será um perfil de todos os usuários e poderá ser usado por qualquer usuário conectado ao computador. Esse parâmetro será ignorado se fSaveProfile for FALSE.
Por padrão, somente membros do grupo Administradores podem salvar um perfil de todos os usuários. Essas configurações de segurança podem ser alteradas usando a função WlanSetSecuritySettings . Seu aplicativo deve ser iniciado por um usuário com privilégios suficientes para que um perfil de todos os usuários seja salvo com êxito.
Se o aplicativo estiver em execução em uma janela da Área de Trabalho Remota, você só poderá salvar um perfil de todos os usuários. Perfis específicos do usuário não podem ser salvos de um aplicativo em execução remotamente.
Retornar valor
Os possíveis valores retornados incluem, mas não se limitam a, o seguinte.
| Código de retorno | Descrição |
|---|---|
|
O método foi concluído com sucesso. |
|
O método falhou. |
|
Um dos parâmetros é inválido. |
|
Não há suporte para uma interface especificada. |
|
O método não pôde alocar a memória necessária para executar essa operação. |
|
Um ponteiro passado como um parâmetro não é válido. |
Comentários
Esse método é assíncrono. Connect retornará S_OK imediatamente se os parâmetros passados para o método forem válidos. No entanto, um código de retorno de S_OK não indica que a conexão foi bem-sucedida. Você deve se registrar para notificações na interface IDot11AdHocNetworkNotificationSink para ser notificado sobre êxito ou falha na conexão. O método IDot11AdHocNetworkNotificationSink::OnStatusChange retorna a conexão status. Para obter mais informações sobre como se registrar para notificações, consulte IDot11AdHocManager.
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 | adhoc.h |