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 16진수 |
| 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 함수를 사용하여 변경할 수 있습니다. 모든 사용자 프로필이 성공적으로 저장되려면 충분한 권한이 있는 사용자가 애플리케이션을 시작해야 합니다.
애플리케이션이 원격 데스크톱 창에서 실행 중인 경우 모든 사용자 프로필만 저장할 수 있습니다. 원격으로 실행되는 애플리케이션에서 사용자별 프로필을 저장할 수 없습니다.
반환 값
가능한 반환 값은 다음을 포함하지만 이에 국한되지 않습니다.
| 반환 코드 | Description |
|---|---|
|
메서드가 완료되었습니다. |
|
메서드가 실패했습니다. |
|
매개 변수 중 하나가 잘못되었습니다. |
|
지정된 인터페이스는 지원되지 않습니다. |
|
메서드가 이 작업을 수행하는 데 필요한 메모리를 할당할 수 없습니다. |
|
매개 변수로 전달된 포인터가 잘못되었습니다. |
설명
이 메서드는 비동기적이며, 메서드 에 전달된 매개 변수가 유효한 경우 Connect는 즉시 S_OK 반환합니다. 그러나 S_OK 반환 코드는 연결에 성공했음을 나타내지 않습니다. 연결 성공 또는 실패를 알리려면 IDot11AdHocNetworkNotificationSink 인터페이스에 알림을 등록해야 합니다. IDot11AdHocNetworkNotificationSink::OnStatusChange 메서드는 연결 상태 반환합니다. 알림 등록에 대한 자세한 내용은 IDot11AdHocManager를 참조하세요.
요구 사항
| 요구 사항 | 값 |
|---|---|
| 지원되는 최소 클라이언트 | Windows Vista [데스크톱 앱만 해당] |
| 지원되는 최소 서버 | Windows Server 2008 [데스크톱 앱만 해당] |
| 대상 플랫폼 | Windows |
| 헤더 | adhoc.h |