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 16진수 |
| 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 인터페이스에 대한 포인터입니다.
반환 값
가능한 반환 값에는 다음이 포함되지만 이에 국한되지는 않습니다.
| 반환 코드 | Description |
|---|---|
|
메서드가 완료되었습니다. |
|
메서드가 실패했습니다. |
|
매개 변수 중 하나가 잘못되었습니다. |
|
지정된 인터페이스는 지원되지 않습니다. |
|
메서드가 이 작업을 수행하는 데 필요한 메모리를 할당할 수 없습니다. |
|
매개 변수로 전달된 포인터가 잘못되었습니다. |
|
지정한 이름을 가진 네트워크가 이미 있습니다. |
|
pInterface 인터페이스는 라디오가 꺼져 있다고 보고합니다. |
|
pInterface 인터페이스는 임시 네트워크를 형성할 수 없다고 보고합니다. 이 조건은 NIC가 임시 네트워크를 지원하지 않거나 NIC가 pSecurity에서 제공하는 보안 설정을 지원하지 않기 때문에 발생할 수 있습니다. |
|
pSecurity 설정은 pInterface 인터페이스에서 지원되지 않습니다. |
|
제공된 암호 가 잘못되었습니다. 제공된 암호가 pSecurity에서 제공하는 보안 설정의 길이가 잘못되었을 수 있습니다. |
|
무선 네트워크 인터페이스 카드 컴퓨터에서 찾을 수 없습니다. |
|
그룹 정책 또는 관리 설정은 네트워크 생성을 금지합니다. |
설명
CreateNetwork 호출이 성공하면 pIAdHoc에서 반환된 네트워크 개체가 프로비전되지만 생성되지 않습니다. CommitCreatedNetwork에 대한 후속 호출은 네트워크를 초기화합니다. 네트워크가 커밋될 때까지 비콘이 전송되지 않습니다.
CreateNetwork 호출 후 네트워크에 연결된 클라이언트 또는 호스트가 없습니다. 애플리케이션은 IDot11AdHocManagerNotificationSink 인터페이스를 사용하여 성공한 연결 시도와 실패한 연결 시도 모두에 대해 알림을 받습니다. 해당 인터페이스의 알림 등록에 대한 자세한 내용은 IDot11AdHocManager를 참조하세요.
요구 사항
| 요구 사항 | 값 |
|---|---|
| 지원되는 최소 클라이언트 | Windows Vista [데스크톱 앱만 해당] |
| 지원되는 최소 서버 | Windows Server 2008 [데스크톱 앱만 해당] |
| 대상 플랫폼 | Windows |
| 헤더 | adhoc.h |