WlanSetProfileEapXmlUserData 함수(wlanapi.h)

아티클
03/04/2024

WlanSetProfileEapXmlUserData 함수는 XML 문자열에 지정된 대로 EAP(Extensible Authentication Protocol) 사용자 자격 증명을 설정합니다. 사용자 자격 증명은 어댑터의 프로필에 적용됩니다. 이러한 자격 증명은 호출자만 사용할 수 있습니다.

구문

DWORD WlanSetProfileEapXmlUserData(
  [in] HANDLE     hClientHandle,
  [in] const GUID *pInterfaceGuid,
  [in] LPCWSTR    strProfileName,
  [in] DWORD      dwFlags,
  [in] LPCWSTR    strEapXmlUserData,
       PVOID      pReserved
);

매개 변수

[in] hClientHandle

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

[in] pInterfaceGuid

인터페이스의 GUID입니다.

[in] strProfileName

EAP 사용자 데이터와 연결된 프로필의 이름입니다. 프로필 이름은 대/소문자를 구분합니다. 이 문자열은 NULL로 종료되어야 합니다.

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

[in] dwFlags

함수의 동작을 수정하는 플래그 집합입니다.

SP2를 사용하는 Windows XP, WINDOWS XP SP3, Windows Vista 및 Windows Server 2008용 무선 LAN API에서 이 매개 변수는 예약되어 있으며 0으로 설정해야 합니다.

Windows 7, Windows Server 2008 R2 이상에서 이 매개 변수는 다음 값 중 하나일 수 있습니다.

값	의미
WLAN_SET_EAPHOST_DATA_ALL_USERS 0x00000001	이 프로필의 모든 사용자에 대한 EAP 호스트 데이터를 설정합니다.

[in] strEapXmlUserData

사용자 자격 증명을 설정하는 데 사용되는 XML 데이터에 대한 포인터입니다.

XML 데이터는 EAPHost 사용자 자격 증명 스키마를 기반으로 해야 합니다. 샘플 사용자 자격 증명 XML 데이터를 보려면 EAPHost 사용자 속성을 참조하세요.

pReserved

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

반환 값

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

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

반환 코드	설명
ERROR_ACCESS_DENIED	액세스가 거부되었습니다. 호출자가 프로필에 대한 쓰기 권한이 없는 경우 이 값이 반환됩니다.
ERROR_BAD_PROFILE	네트워크 연결 프로필이 손상되었습니다. strProfileName 매개 변수에 지정된 프로필을 구문 분석할 수 없는 경우 이 오류가 반환됩니다.
ERROR_INVALID_PARAMETER	매개 변수가 잘못되었습니다. 다음 조건이 발생하면 이 값이 반환됩니다. hClientHandle 은 NULL입니다. pInterfaceGuid 는 NULL입니다. strProfileName 은 NULL입니다. strEapXmlUserData 가 NULL입니다. pReserved 가 NULL이 아닙니다.
ERROR_INVALID_HANDLE	핸들이 잘못되었습니다. 핸들 테이블에서 hClientHandle 핸들을 찾을 수 없는 경우 이 오류가 반환됩니다.
ERROR_NOT_ENOUGH_MEMORY	이 명령을 처리하는 데 사용할 수 있는 스토리지가 부족합니다.
ERROR_NOT_SUPPORTED	요청이 지원되지 않습니다. 이 값은 프로필 설정이 사용자 데이터의 스토리지를 허용하지 않을 때 반환됩니다. 이 문제는 SSO(Single Signon)를 사용할 때 발생할 수 있습니다. Windows 7, Windows Server 2008 R2 이상에서는 인증에 802.1X 이외의 메서드를 사용하는 프로필에서 WlanSetProfileEapXmlUserData 함수가 호출된 경우 이 값이 반환됩니다.
ERROR_SERVICE_NOT_ACTIVE	서비스가 시작되지 않았습니다. 무선 LAN 서비스가 실행되고 있지 않으면 이 값이 반환됩니다.
RPC_STATUS	다양한 오류 코드.

설명

WlanSetProfileEapXmlUserData 함수는 프로필에서 사용할 EAP 사용자 자격 증명을 설정합니다. 이 함수는 인증에 802.1X를 사용하는 프로필에서만 호출할 수 있습니다. Windows Vista 및 Windows Server 2008에서 이러한 자격 증명은 호출자만 사용할 수 있습니다.

eapType 매개 변수는 EAP 메서드에 대한 형식, 식별 및 작성자 정보를 포함하는 EAP_METHOD_TYPE 구조체입니다. EAP_METHOD_TYPE 구조체의 eapType 멤버는 EAP 메서드에 대한 형식 및 공급업체 식별 정보를 포함하는 EAP_TYPE 구조체입니다.

EAP 메서드 형식 할당에 대한 자세한 내용은 IETF에서 게시한 RFC 3748의 섹션 6.2를 참조하세요.

Windows 10, Windows Server 2016 이상에서는 WlanSetProfileEapXmlUserData 함수가 향상됩니다. dwFlags 매개 변수에 WLAN_SET_EAPHOST_DATA_ALL_USERS 포함된 경우 프로필의 모든 사용자에 대해 EAP 사용자 자격 증명을 설정할 수 있습니다.

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

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

EAP-TTLS를 사용하고 64비트 OS(운영 체제)에서 실행되는 32비트 애플리케이션에서 API가 호출될 때 WlanSetProfileEapXmlUserData로 인해 무선 연결이 실패할 수 있습니다. 애플리케이션은 대상 OS와 동일한 CPU 아키텍처를 위해 빌드되어야 합니다.

WINDOWS XP SP3 및 Windows XP용 무선 LAN API SP2 사용: 이 함수는 PEAP(Protected EAP) 자격 증명에만 사용할 수 있습니다. 다른 EAP 형식에는 사용할 수 없습니다.

요구 사항

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