Método IDot11AdHocNetwork::Connect (adhoc.h)
Se conecta a una red ad hoc inalámbrica creada anteriormente. Para que una aplicación pueda conectarse a una red, la red debe haberse creado con IDot11AdHocManager::CreateNetwork y confirmada mediante IDot11AdHocManager::CommitCreatedNetwork.
Sintaxis
HRESULT Connect(
[in] LPCWSTR Passphrase,
[in] LONG GeographicalId,
[in] BOOLEAN fSaveProfile,
[in] BOOLEAN fMakeSavedProfileUserSpecific
);
Parámetros
[in] Passphrase
Cadena de contraseña usada para autenticar el usuario o la máquina en la red.
La longitud de la cadena de contraseña depende de la configuración de seguridad pasada en el parámetro pSecurity de la llamada a CreateNetwork . En la tabla siguiente se muestra la longitud de la contraseña asociada a varias configuraciones de seguridad.
| Configuración de seguridad | Longitud de contraseña |
|---|---|
| Open-None | 0 |
| Open-WEP | 5 o 13 caracteres; 10 o 26 dígitos hexadecimales |
| WPA2PSK | De 8 a 63 caracteres |
Para ver los valores enumerados que corresponden al par de configuración de seguridad anterior, consulte DOT11_ADHOC_AUTH_ALGORITHM y DOT11_ADHOC_CIPHER_ALGORITHM.
[in] GeographicalId
Ubicación geográfica en la que se creó la red. Para obtener una lista de valores posibles, vea Tabla de ubicaciones geográficas.
[in] fSaveProfile
Parámetro opcional que especifica si se debe guardar un perfil inalámbrico. Si es TRUE, el perfil se guarda en el almacén de perfiles. Una vez guardado un perfil, el usuario puede modificar el perfil mediante la interfaz de usuario Administrar red inalámbrica . Los perfiles también se pueden modificar mediante las funciones Wifi nativas.
Al guardar un perfil, se modifica la firma de red devuelta por IDot11AdHocNetwork::GetSignature.
[in] fMakeSavedProfileUserSpecific
Parámetro opcional que especifica si el perfil que se va a guardar es un perfil de usuario completo. Si se establece en TRUE, el perfil es específico del usuario actual. Si se establece en FALSE, el perfil es un perfil de usuario completo y cualquier usuario que haya iniciado sesión en la máquina. Este parámetro se omite si fSaveProfile es FALSE.
De forma predeterminada, solo los miembros del grupo Administradores pueden guardar un perfil de usuario completo. Esta configuración de seguridad se puede modificar mediante la función WlanSetSecuritySettings . Un usuario debe iniciar la aplicación con privilegios suficientes para que un perfil de todos los usuarios se guarde correctamente.
Si la aplicación se ejecuta en una ventana de Escritorio remoto, solo puede guardar un perfil de usuario completo. Los perfiles específicos del usuario no se pueden guardar desde una aplicación que se ejecuta de forma remota.
Valor devuelto
Entre los valores devueltos posibles se incluyen, entre otros, los siguientes.
| Código devuelto | Descripción |
|---|---|
|
El método se completó correctamente. |
|
Error en el método. |
|
Uno de los parámetros no es válido. |
|
No se admite una interfaz especificada. |
|
El método no pudo asignar la memoria necesaria para realizar esta operación. |
|
Un puntero pasado como parámetro no es válido. |
Comentarios
Este método es asincrónico. Connect devuelve S_OK inmediatamente si los parámetros pasados al método son válidos. Sin embargo, un código de retorno de S_OK no indica que la conexión se realizó correctamente. Debe registrarse para recibir notificaciones en la interfaz IDot11AdHocNetworkNotificationSink para recibir una notificación de que la conexión se ha realizado correctamente o no. El método IDot11AdHocNetworkNotificationSink::OnStatusChange devuelve el estado de conexión. Para obtener más información sobre el registro de notificaciones, consulte IDot11AdHocManager.
Requisitos
| Requisito | Value |
|---|---|
| Cliente mínimo compatible | Windows Vista [solo aplicaciones de escritorio] |
| Servidor mínimo compatible | Windows Server 2008 [solo aplicaciones de escritorio] |
| Plataforma de destino | Windows |
| Encabezado | adhoc.h |