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
S_OK	El método se completó correctamente.
E_FAIL	Error en el método.
E_INVALIDARG	Uno de los parámetros no es válido.
E_NOINTERFACE	No se admite una interfaz especificada.
E_OUTOFMEMORY	El método no pudo asignar la memoria necesaria para realizar esta operación.
E_POINTER	Un puntero pasado como parámetro no es válido.
HRESULT_FROM_WIN32(ERROR_ALREADY_EXISTS)	Ya existe una red con el nombre especificado.
HRESULT_FROM_WIN32(ERROR_NOT_READY)	La interfaz pInterface informa de que su radio está desactivada.
HRESULT_FROM_WIN32(ERROR_NOT_CAPABLE)	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.
HRESULT_FROM_WIN32(ERROR_NOT_SUPPORTED)	La configuración de pSecurity no es compatible con la interfaz pInterface .
HRESULT_FROM_WIN32(ERROR_ILL_FORMED_PASSWORD)	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.
HRESULT_FROM_WIN32(ERROR_NOT_FOUND)	No se encontró una tarjeta de interfaz de red inalámbrica en la máquina.
HRESULT_FROM_WIN32(ERROR_CURRENT_DOMAIN_NOT_ALLOWED)	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

Consulte también

CommitCreatedNetwork

IDot11AdHocManager