다음을 통해 공유

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.

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

반환 코드 설명
ERROR_ACCESS_DENIED
 호출자에게 프로필 목록을 변경할 수 있는 충분한 권한이 없습니다.

WlanSetProfileList가 프로필 목록에서 모든 사용자 프로필의 상대 순서를 변경하거나 모든 사용자 프로필을 프로필 목록의 하위 위치로 이동하는 작업을 수행하기 전에 WlanSetProfileList는 wlan_secure_all_user_profiles_order 개체와 함께 저장된 DACL(임의 액세스 제어 목록)을 검색합니다. DACL에 호출 스레드의 액세스 토큰에 대한 WLAN_WRITE_ACCESS 권한을 부여하는 ACE(액세스 제어 항목)가 없는 경우 WlanSetProfileList 는 ERROR_ACCESS_DENIED 반환합니다.
ERROR_INVALID_HANDLE
 핸들 테이블에서 hClientHandle 핸들을 찾을 수 없습니다.
ERROR_INVALID_PARAMETER
 다음 조건 중 하나가 발생했습니다.
  • hClientHandle 이 NULL 이거나 잘못되었습니다.
  • pInterfaceGuid 는 NULL입니다.
  • dwItems는 0입니다.
  • strProfileNames 는 NULL입니다.
  • strProfileNames에 동일한 프로필 이름이 두 번 이상 나타납니다.
  • pReserved 가 NULL이 아닙니다.
ERROR_NOT_FOUND
 strProfileNames 에는 프로필 저장소에 없는 프로필의 이름이 포함됩니다.
RPC_STATUS
 다양한 오류 코드.

설명

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

추가 정보

WlanGetProfile

WlanGetProfileList

WlanSetProfile