共用方式為

IDot11AdHocNetwork：：Connect 方法 (adhoc.h)

  • 發行項

線上到先前建立的無線臨機操作網路。 應用程式必須先使用 IDot11AdHocManager：：CreateNetwork 建立網路，並使用 IDot11AdHocManager：：CommitCreatedNetwork 來認可網路。

語法

HRESULT Connect(
  [in] LPCWSTR Passphrase,
  [in] LONG    GeographicalId,
  [in] BOOLEAN fSaveProfile,
  [in] BOOLEAN fMakeSavedProfileUserSpecific
);

參數

[in] Passphrase

用來驗證網路上用戶或計算機的密碼字串。

密碼字串的長度取決於在 CreateNetwork 呼叫的 pSecurity 參數中傳遞的安全性設定。 下表顯示與各種安全性設定相關聯的密碼長度。

安全性設定 密碼長度
Open-None 0
Open-WEP 5 或 13 個字元;10 或 26 個十六進位數位
WPA2PSK 8 到 63 個字元
 

如需對應至上述安全性設定組的列舉值，請參閱 DOT11_ADHOC_AUTH_ALGORITHM 和 DOT11_ADHOC_CIPHER_ALGORITHM。

[in] GeographicalId

建立網路的地理位置。 如需可能值的清單，請參閱 地理位置數據表。

[in] fSaveProfile

選擇性參數，指定是否應該儲存無線配置檔。 如果 為 TRUE，則設定檔會儲存至配置檔存放區。 儲存配置檔之後，使用者就可以使用 管理無線網路 使用者介面來修改配置檔。 您也可以使用 原生 Wifi 函式來修改設定檔。

儲存配置檔會修改 IDot11AdHocNetwork：：GetSignature 所傳回的網路簽章。

[in] fMakeSavedProfileUserSpecific

選擇性參數，指定要儲存的配置檔是否為所有使用者配置檔。 如果設定為 TRUE，則配置檔是目前使用者特有的。 如果設定為 FALSE，則設定檔是所有使用者配置檔，可供任何登入計算機的使用者使用。 如果 fSaveProfile 為 FALSE，則會忽略此參數。

根據預設，只有 Administrators 群組的成員可以儲存所有使用者配置檔。 您可以使用 WlanSetSecuritySettings 函式來改變這些安全性設定。 您的應用程式必須由具有足夠許可權的用戶啟動，才能成功儲存所有使用者配置檔。

如果您的應用程式是在遠端桌面視窗中執行，您只能儲存所有使用者設定檔。 使用者特定配置檔無法從遠端執行的應用程式儲存。

傳回值

可能的傳回值包括，但不限於下列各項。

傳回碼 描述
S_OK
 已成功完成命令。
E_FAIL
 方法失敗。
E_INVALIDARG
 其中一個參數無效。
E_NOINTERFACE
 不支援指定的介面。
E_OUTOFMEMORY
 方法無法配置執行這項作業所需的記憶體。
E_POINTER
 傳遞為參數的指標無效。

備註

這個方法是非同步方法。 如果傳遞至 方法的參數有效，Connect 會立即傳回S_OK。 不過，S_OK的傳回碼並不表示連線成功。 您必須註冊 IDot11AdHocNetworkNotificationSink 介面上的通知，才能收到連線成功或失敗的通知。 IDot11AdHocNetworkNotificationSink：：OnStatusChange 方法會傳回連線狀態。 如需註冊通知的詳細資訊，請參閱 IDot11AdHocManager。

規格需求

需求 值
最低支援的用戶端 Windows Vista [僅限傳統型應用程式]
最低支援的伺服器 Windows Server 2008 [僅限傳統型應用程式]
目標平台 Windows
標頭 adhoc.h

另請參閱

IDot11AdHocNetwork

IDot11AdHocNetwork：:D isconnect