Método IDot11AdHocManager::CreateNetwork (adhoc.h)
Crea una red ad hoc inalámbrica. Otros clientes y hosts pueden conectarse a esta red.
Sintaxis
HRESULT CreateNetwork(
[in] LPCWSTR Name,
[in] LPCWSTR Password,
[in] LONG GeographicalId,
[in] IDot11AdHocInterface *pInterface,
[in] IDot11AdHocSecuritySettings *pSecurity,
[in] GUID *pContextGuid,
[out] IDot11AdHocNetwork **pIAdHoc
);
Parámetros
[in] Name
Nombre descriptivo de la red. Esta cadena debe limitarse a 32 caracteres. El SSID debe usarse como nombre descriptivo. Este nombre se transmite en una baliza.
[in] Password
Contraseña usada para la autenticación de equipo o usuario en la red.
La longitud de la cadena de contraseña depende de la configuración de seguridad pasada en el parámetro pSecurity . 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 creará la red. Para obtener una lista de valores posibles, vea Tabla de ubicaciones geográficas.
Si la interfaz no es 802.11d conforme, este valor se omite. Esto significa que si IDot11AdHocInterface::IsDot11d devuelve FALSE, este valor se omite.
Si no está seguro de qué valor usar, establezca GeographicalId en CTRY_DEFAULT. Si usa CTRY_DEFAULT, no se aplica la conformidad 802.11d.
[in] pInterface
Puntero opcional a un IDot11AdHocInterface que especifica la interfaz de red en la que se crea la nueva red. Si este parámetro es NULL, se usa la primera interfaz sin usar. Si todas las interfaces están en uso, se usa la primera interfaz enumerada. En ese caso, la red anterior de la interfaz se desconecta.
[in] pSecurity
Puntero a una interfaz IDot11AdHocSecuritySettings que especifica la configuración de seguridad usada en la red.
[in] pContextGuid
Parámetro opcional que especifica el GUID de la aplicación que creó la red. Una aplicación puede usar este identificador para limitar las redes enumeradas por GetIEnumDot11AdHocNetworks a las redes creadas por la aplicación. Para que este filtrado funcione correctamente, todas las instancias de la aplicación en todas las máquinas deben usar el mismo GUID.
[out] pIAdHoc
Puntero a una interfaz IDot11AdHocNetwork que representa la red creada.
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. |
|
Ya existe una red con el nombre especificado. |
|
La interfaz pInterface informa de que su radio está desactivada. |
|
La interfaz pInterface informa de que no es capaz de formar una red ad hoc. Esta condición puede producirse porque la NIC no admite redes ad hoc o porque la NIC no admite la configuración de seguridad proporcionada por pSecurity. |
|
La configuración de pSecurity no es compatible con la interfaz pInterface . |
|
La contraseña proporcionada no es válida. La contraseña proporcionada puede ser una longitud no válida para la configuración de seguridad proporcionada por pSecurity. |
|
No se encontró una tarjeta de interfaz de red inalámbrica en la máquina. |
|
La directiva de grupo o la configuración administrativa prohíben la creación de la red. |
Comentarios
Después de una llamada correcta a CreateNetwork , el objeto de red devuelto por pIAdHoc se aprovisiona pero no se construye. Una llamada posterior a CommitCreatedNetwork inicializa la red. Las balizas no se envían hasta que se confirme la red.
No hay clientes o hosts conectados a la red después de una llamada a CreateNetwork . Las aplicaciones reciben una notificación de intentos de conexión correctos y erróneos mediante la interfaz IDot11AdHocManagerNotificationSink . Para obtener información sobre el registro de notificaciones en esa interfaz, vea 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 |