WlanSetProfileList 함수(wlanapi.h)
WlanSetProfileList 함수는 지정된 인터페이스에 대한 프로필의 기본 설정 순서를 설정합니다.
구문
DWORD WlanSetProfileList(
[in] HANDLE hClientHandle,
[in] const GUID *pInterfaceGuid,
[in] DWORD dwItems,
[in] LPCWSTR *strProfileNames,
PVOID pReserved
);
매개 변수
[in] hClientHandle
WlanOpenHandle 함수에 대한 이전 호출에서 얻은 클라이언트의 세션 핸들입니다.
[in] pInterfaceGuid
인터페이스의 GUID입니다.
[in] dwItems
strProfileNames 매개 변수의 프로필 수입니다.
[in] strProfileNames
원하는 순서로 된 프로필의 이름입니다. 프로필 이름은 대/소문자를 구분합니다. 이 문자열은 NULL로 종료되어야 합니다.
WINDOWS XP SP3 및 Windows XP용 무선 LAN API SP2 사용: 제공된 이름은 네트워크의 SSID에서 자동으로 파생된 프로필 이름과 일치해야 합니다. 인프라 네트워크 프로필의 경우 프로필 이름에 대해 SSID를 제공해야 합니다. 임시 네트워크 프로필의 경우 제공된 이름은 임시 네트워크의 SSID 뒤에 가 있어야 -adhoc합니다.
pReserved
다음에 사용하도록 예약됩니다. NULL로 설정해야 합니다.
반환 값
함수가 성공하면 반환 값이 ERROR_SUCCESS.
함수가 실패하면 반환 값은 다음 반환 코드 중 하나일 수 있습니다.
| 반환 코드 | 설명 |
|---|---|
|
호출자에게 프로필 목록을 변경할 수 있는 충분한 권한이 없습니다.
WlanSetProfileList가 프로필 목록에서 모든 사용자 프로필의 상대 순서를 변경하거나 모든 사용자 프로필을 프로필 목록의 하위 위치로 이동하는 작업을 수행하기 전에 WlanSetProfileList는 wlan_secure_all_user_profiles_order 개체와 함께 저장된 DACL(임의 액세스 제어 목록)을 검색합니다. DACL에 호출 스레드의 액세스 토큰에 대한 WLAN_WRITE_ACCESS 권한을 부여하는 ACE(액세스 제어 항목)가 없는 경우 WlanSetProfileList 는 ERROR_ACCESS_DENIED 반환합니다. |
|
핸들 테이블에서 hClientHandle 핸들을 찾을 수 없습니다. |
|
다음 조건 중 하나가 발생했습니다.
|
|
strProfileNames 에는 프로필 저장소에 없는 프로필의 이름이 포함됩니다. |
|
다양한 오류 코드. |
설명
WlanSetProfileList 함수는 지정된 무선 인터페이스에 대한 무선 LAN 프로필의 기본 설정 순서를 설정합니다.
목록의 프로필은 WlanGetProfileList 함수에서 반환된 현재 프로필과 일대일 일치해야 합니다. 그룹 정책 프로필의 위치를 변경할 수 없습니다.
모든 무선 LAN 함수는 프로필 작업을 수행할 때 무선 인터페이스에 대한 인터페이스 GUID가 필요합니다. 무선 인터페이스가 제거되면 WLANSVC(무선 LAN 서비스)에서 해당 상태가 지워지고 프로필 작업이 불가능합니다.
pInterfaceGuid 매개 변수에 지정된 무선 인터페이스가 시스템에서 제거된 경우(예: 제거된 USB 무선 어댑터) ERROR_INVALID_PARAMETER WlanSetProfileList 함수가 실패할 수 있습니다.
요구 사항
| 요구 사항 | 값 |
|---|---|
| 지원되는 최소 클라이언트 | Windows Vista, WINDOWS XP SP3 [데스크톱 앱만 해당] |
| 지원되는 최소 서버 | Windows Server 2008 [데스크톱 앱만 해당] |
| 대상 플랫폼 | Windows |
| 헤더 | wlanapi.h(Wlanapi.h 포함) |
| 라이브러리 | Wlanapi.lib |
| DLL | Wlanapi.dll |
| 재배포 가능 파일 | WINDOWS XP용 무선 LAN API SP2 |