Поделиться через

Метод IDot11AdHocManager::CreateNetwork (adhoc.h)

  • Статья

Создает беспроводную сеть ad hoc. Другие клиенты и узлы могут подключаться к этой сети.

Синтаксис

HRESULT CreateNetwork(
  [in]  LPCWSTR                     Name,
  [in]  LPCWSTR                     Password,
  [in]  LONG                        GeographicalId,
  [in]  IDot11AdHocInterface        *pInterface,
  [in]  IDot11AdHocSecuritySettings *pSecurity,
  [in]  GUID                        *pContextGuid,
  [out] IDot11AdHocNetwork          **pIAdHoc
);

Параметры

[in] Name

Понятное имя сети. Эта строка должна быть ограничена 32 символами. В качестве понятного имени следует использовать SSID. Это имя передается в виде маяка.

[in] Password

Пароль, используемый для проверки подлинности компьютера или пользователя в сети.

Длина строки пароля зависит от параметров безопасности, передаваемых в параметре pSecurity . В следующей таблице показана длина пароля, связанная с различными параметрами безопасности.

Параметры безопасности Длина пароля
Open-None 0
Open-WEP 5 или 13 символов; 10 или 26 шестнадцатеричных цифр
WPA2PSK От 8 до 63 символов
 

Перечисленные значения, соответствующие приведенной выше паре параметров безопасности, см. в разделе DOT11_ADHOC_AUTH_ALGORITHM и DOT11_ADHOC_CIPHER_ALGORITHM

[in] GeographicalId

Географическое расположение, в котором будет создана сеть. Список возможных значений см. в разделе Таблица географических расположений.

Если интерфейс не соответствует 802.11d, это значение игнорируется. Это означает, что если IDot11AdHocInterface::IsDot11d возвращает значение FALSE, это значение игнорируется.

Если вы не знаете, какое значение следует использовать, задайте для параметра GeographicalId значение CTRY_DEFAULT. При использовании CTRY_DEFAULT соответствие 802.11d не применяется.

[in] pInterface

Необязательный указатель на IDot11AdHocInterface , указывающий сетевой интерфейс, на котором создается новая сеть. Если этот параметр имеет значение NULL, используется первый неиспользуемый интерфейс. Если используются все интерфейсы, используется первый перечислимый интерфейс. В этом случае предыдущая сеть в интерфейсе отключена.

[in] pSecurity

Указатель на интерфейс IDot11AdHocSecuritySettings , указывающий параметры безопасности, используемые в сети.

[in] pContextGuid

Необязательный параметр, указывающий GUID приложения, создавшего сеть. Приложение может использовать этот идентификатор, чтобы ограничить сети, перечисленные GetIEnumDot11AdHocNetworks , сетями, созданными приложением. Чтобы эта фильтрация работала правильно, все экземпляры приложения на всех компьютерах должны использовать один и тот же GUID.

[out] pIAdHoc

Указатель на интерфейс IDot11AdHocNetwork , представляющий созданную сеть.

Возвращаемое значение

Возможные возвращаемые значения включают, помимо прочего, следующие.

Код возврата Описание
S_OK
 Метод завершился успешно.
E_FAIL
 Сбой метода.
E_INVALIDARG
 Один из параметров недопустим.
E_NOINTERFACE
 Указанный интерфейс не поддерживается.
E_OUTOFMEMORY
 Методу не удалось выделить память, необходимую для выполнения этой операции.
E_POINTER
 Недопустимый указатель, переданный в качестве параметра.
HRESULT_FROM_WIN32(ERROR_ALREADY_EXISTS)
 Сеть с указанным именем уже существует.
HRESULT_FROM_WIN32(ERROR_NOT_READY)
 Интерфейс pInterface сообщает, что его радио отключено.
HRESULT_FROM_WIN32(ERROR_NOT_CAPABLE)
 Интерфейс pInterface сообщает, что он не способен сформировать нерегламентированной сети. Это может быть вызвано тем, что сетевой адаптер не поддерживает нерегламентированные сети или не поддерживает параметры безопасности, предоставляемые pSecurity.
HRESULT_FROM_WIN32(ERROR_NOT_SUPPORTED)
 Параметры pSecurity не поддерживаются интерфейсом pInterface .
HRESULT_FROM_WIN32(ERROR_ILL_FORMED_PASSWORD)
 Указан недопустимый пароль . Указанный пароль может иметь недопустимую длину для параметров безопасности, предоставляемых pSecurity.
HRESULT_FROM_WIN32(ERROR_NOT_FOUND)
 На компьютере не найден карта беспроводного сетевого интерфейса.
HRESULT_FROM_WIN32(ERROR_CURRENT_DOMAIN_NOT_ALLOWED)
 Групповая политика или административные параметры запрещают создание сети.

Комментарии

После успешного вызова CreateNetwork сетевой объект, возвращенный pIAdHoc , подготавливается, но не создается. Последующий вызов CommitCreatedNetwork инициализирует сеть. Маяки не отправляются до тех пор, пока сеть не будет зафиксирована.

Клиенты или узлы, подключенные к сети после вызова CreateNetwork , отсутствуют. Приложения получают уведомления об успешных и неудачных попытках подключения с помощью интерфейса IDot11AdHocManagerNotificationSink . Сведения о регистрации для получения уведомлений в этом интерфейсе см. в разделе IDot11AdHocManager.

Требования

Требование Значение
Минимальная версия клиента Windows Vista [только классические приложения]
Минимальная версия сервера Windows Server 2008 [только классические приложения]
Целевая платформа Windows
Header adhoc.h

См. также раздел

CommitCreatedNetwork

IDot11AdHocManager