WlanSetProfilePosition 함수(wlanapi.h)

WlanSetProfilePosition 함수는 기본 설정 목록에서 지정된 단일 프로필의 위치를 설정합니다.

구문

DWORD WlanSetProfilePosition(
  [in] HANDLE     hClientHandle,
  [in] const GUID *pInterfaceGuid,
  [in] LPCWSTR    strProfileName,
  [in] DWORD      dwPosition,
       PVOID      pReserved
);

매개 변수

[in] hClientHandle

WlanOpenHandle 함수에 대한 이전 호출에서 얻은 클라이언트의 세션 핸들입니다.

[in] pInterfaceGuid

인터페이스의 GUID입니다.

[in] strProfileName

프로필의 이름입니다. 프로필 이름은 대/소문자를 구분합니다. 이 문자열은 NULL로 종료되어야 합니다.

WINDOWS XP SP3 및 Windows XP용 무선 LAN API SP2 사용: 제공된 이름은 네트워크의 SSID에서 자동으로 파생된 프로필 이름과 일치해야 합니다. 인프라 네트워크 프로필의 경우 프로필 이름에 대해 SSID를 제공해야 합니다. 임시 네트워크 프로필의 경우 제공된 이름은 임시 네트워크의 SSID 다음에 이 -adhoc어서야 합니다.

[in] dwPosition

기본 설정 목록에서 프로필을 이동해야 하는 위치를 나타냅니다. 0은 WlanGetProfileList 함수에서 반환되는 목록의 첫 번째 프로필에 해당합니다.

pReserved

다음에 사용하도록 예약됩니다. NULL로 설정해야 합니다.

반환 값

함수가 성공하면 반환 값이 ERROR_SUCCESS.

함수가 실패하면 반환 값은 다음 반환 코드 중 하나일 수 있습니다.

반환 코드	설명
ERROR_ACCESS_DENIED	호출자에게 프로필 위치를 변경할 수 있는 충분한 권한이 없습니다. WlanSetProfilePosition이 프로필 목록에서 모든 사용자 프로필의 상대 순서를 변경하거나 모든 사용자 프로필을 프로필 목록의 하위 위치로 이동하는 작업을 수행하기 전에 WlanSetProfilePosition은 wlan_secure_all_user_profiles_order 개체와 함께 저장된 DACL(임의 액세스 제어 목록)을 검색합니다. DACL에 호출 스레드의 액세스 토큰에 대한 WLAN_WRITE_ACCESS 권한을 부여하는 ACE(액세스 제어 항목)가 포함되어 있지 않으면 WlanSetProfilePosition 은 ERROR_ACCESS_DENIED 반환합니다.
ERROR_INVALID_PARAMETER	hClientHandle 이 NULL 이거나 잘못되었거나, pInterfaceGuid 가 NULL이거나, strProfileName 이 NULL이거나, pReserved 가 NULL이 아닙니다.
ERROR_INVALID_HANDLE	핸들 테이블에서 hClientHandle 핸들을 찾을 수 없습니다.
RPC_STATUS	다양한 오류 코드.

설명

그룹 정책 프로필의 위치를 변경할 수 없습니다.

기본적으로 Administrators 그룹의 구성원으로 로그온한 사용자만 모든 사용자 프로필의 위치를 변경할 수 있습니다. WlanGetSecuritySettings를 호출하여 모든 사용자 프로필의 위치를 변경하는 데 필요한 실제 사용자 권한을 결정합니다.

명령줄에서 프로필 위치를 설정하려면 netsh wlan set profileorder 명령을 사용합니다. 자세한 내용은 무선 로컬 영역 네트워크(wlan)에 대한 Netsh 명령을 참조하세요.

WINDOWS XP SP3 및 Windows XP용 무선 LAN API SP2 사용: 임시 프로필은 프로필 목록의 인프라 프로필 다음에 표시됩니다. WlanSetProfilePosition을 사용하여 인프라 프로필 앞에 임시 프로필을 배치하려고 하면 WlanSetProfilePosition 호출이 성공하지만 무선 제로 구성 서비스는 모든 인프라 네트워크 프로필 뒤에 임시 프로필이 배치되도록 프로필 목록을 다시 정렬합니다.

게스트 프로필, WPS(무선 프로비저닝 서비스) 인증을 사용하는 프로필 및 WPA-None(Wi-Fi 보호된 Access-None) 인증이 있는 프로필은 지원되지 않습니다. 기본 설정 프로필 목록에 나타나는 이러한 프로필은 프로필 목록에서 고정된 위치를 가합니다. 즉 , WlanSetProfilePosition 을 사용하여 위치를 변경할 수 없으며 해당 위치는 다른 프로필의 위치 변경에 의해 영향을 받지 않습니다.

모든 무선 LAN 함수는 프로필 작업을 수행할 때 무선 인터페이스에 대한 인터페이스 GUID가 필요합니다. 무선 인터페이스가 제거되면 WLANSVC(무선 LAN 서비스)에서 해당 상태가 지워지고 프로필 작업이 불가능합니다.

pInterfaceGuid 매개 변수에 지정된 무선 인터페이스가 시스템에서 제거된 경우(예: 제거된 USB 무선 어댑터) ERROR_INVALID_PARAMETER WlanSetProfilePosition 함수가 실패할 수 있습니다.

요구 사항

요구 사항	값
지원되는 최소 클라이언트	Windows Vista, WINDOWS XP SP3 [데스크톱 앱만 해당]
지원되는 최소 서버	Windows Server 2008 [데스크톱 앱만 해당]
대상 플랫폼	Windows
헤더	wlanapi.h(Wlanapi.h 포함)
라이브러리	Wlanapi.lib
DLL	Wlanapi.dll
재배포 가능 파일	WINDOWS XP용 무선 LAN API SP2

추가 정보

WlanGetProfile

WlanGetProfileList

WlanSetProfile

WlanSetProfileList