共用方式為

IDot11AdHocManager：：CreateNetwork 方法 (adhoc.h)

  • 發行項

建立無線臨機操作網路。 其他用戶端和主機可以連線到此網路。

語法

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.11 標準，則會忽略此值。 這表示如果 IDot11AdHocInterface：：IsDot11d 傳 回 FALSE，則會忽略此值。

如果您不確定要使用的值，請將 [地理標識符 ] 設定為 [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 介面會報告它無法形成臨機操作網路。 發生此狀況的原因是 NIC 不支援臨機操作網路，或 NIC 不支援 pSecurity 所提供的安全性設定。
HRESULT_FROM_WIN32 (ERROR_NOT_SUPPORTED)
pInterface 介面不支援 pSecurity 設定。
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
標頭 adhoc.h

另請參閱

CommitCreatedNetwork

IDot11AdHocManager