Método IDot11AdHocManager::CreateNetwork (adhoc.h)
Cria uma rede ad hoc sem fio. Outros clientes e hosts podem se conectar a essa rede.
Sintaxe
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
O nome amigável da rede. Essa cadeia de caracteres deve ser limitada a 32 caracteres. O SSID deve ser usado como o nome amigável. Esse nome é transmitido em um farol.
[in] Password
A senha usada para autenticação de computador ou usuário na rede.
O comprimento da cadeia de caracteres de senha depende das configurações de segurança passadas no parâmetro pSecurity . 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 será criada. Para obter uma lista de valores possíveis, consulte Tabela de Localizações Geográficas.
Se a interface não for compatível com 802,11d, esse valor será ignorado. Isso significa que se IDot11AdHocInterface::IsDot11d retornar FALSE, esse valor será ignorado.
Se você não tiver certeza de qual valor usar, defina GeographicalId como CTRY_DEFAULT. Se você usar CTRY_DEFAULT, a conformidade 802.11d não será imposta.
[in] pInterface
Um ponteiro opcional para um IDot11AdHocInterface que especifica o adaptador de rede no qual a nova rede é criada. Se esse parâmetro for NULL, a primeira interface não utilizada será usada. Se todas as interfaces estiverem em uso, a primeira interface enumerada será usada. Nesse caso, a rede anterior na interface é desconectada.
[in] pSecurity
Um ponteiro para uma interface IDot11AdHocSecuritySettings que especifica as configurações de segurança usadas na rede.
[in] pContextGuid
Um parâmetro opcional que especifica o GUID do aplicativo que criou a rede. Um aplicativo pode usar esse identificador para limitar as redes enumeradas por GetIEnumDot11AdHocNetworks às redes criadas pelo aplicativo. Para que essa filtragem funcione corretamente, todas as instâncias do aplicativo em todos os computadores devem usar o mesmo GUID.
[out] pIAdHoc
Um ponteiro para uma interface IDot11AdHocNetwork que representa a rede criada.
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. |
|
Já existe uma rede com o Nome especificado. |
|
A interface pInterface informa que seu rádio está desativado. |
|
A interface pInterface informa que não é capaz de formar uma rede ad hoc. Essa condição pode ocorrer porque a NIC não dá suporte a redes ad hoc ou porque a NIC não dá suporte às configurações de segurança fornecidas pelo pSecurity. |
|
As configurações de pSecurity não são compatíveis com a interface pInterface . |
|
A Senha fornecida é inválida. A senha fornecida pode ser um comprimento inválido para as configurações de segurança fornecidas pelo pSecurity. |
|
Um cartão de interface de rede sem fio não foi encontrado no computador. |
|
A política de grupo ou as configurações administrativas proíbem a criação da rede. |
Comentários
Após uma chamada CreateNetwork bem-sucedida, o objeto de rede retornado por pIAdHoc é provisionado, mas não construído. Uma chamada subsequente para CommitCreatedNetwork inicializa a rede. Os beacons não são enviados até que a rede seja confirmada.
Não há clientes ou hosts conectados à rede após uma chamada CreateNetwork . Os aplicativos são notificados sobre tentativas de conexão bem-sucedidas e com falha usando a interface IDot11AdHocManagerNotificationSink . Para obter informações sobre o registro de notificações nessa interface, 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 |