WlanSetProfileEapUserData 함수(wlanapi.h)

아티클
08/28/2023

WlanSetProfileEapUserData 함수는 원시 EAP 데이터에 지정된 대로 EAP(Extensible Authentication Protocol) 사용자 자격 증명을 설정합니다. 사용자 자격 증명은 인터페이스의 프로필에 적용됩니다.

구문

DWORD WlanSetProfileEapUserData(
  [in] HANDLE          hClientHandle,
  [in] const GUID      *pInterfaceGuid,
  [in] LPCWSTR         strProfileName,
  [in] EAP_METHOD_TYPE eapType,
  [in] DWORD           dwFlags,
  [in] DWORD           dwEapUserDataSize,
  [in] const LPBYTE    pbEapUserData,
       PVOID           pReserved
);

매개 변수

[in] hClientHandle

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

[in] pInterfaceGuid

인터페이스의 GUID입니다.

[in] strProfileName

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

[in] eapType

호출자가 EAP 사용자 자격 증명을 제공하는 메서드를 포함하는 EAP_METHOD_TYPE 구조체입니다.

[in] dwFlags

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

Windows Vista 및 Windows Server 2008에서 이 매개 변수는 예약되어 있으며 0으로 설정해야 합니다.

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

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

[in] dwEapUserDataSize

pbEapUserData가 가리키는 데이터의 크기(바이트)입니다.

[in] pbEapUserData

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

Windows Vista 및 Windows Server 2008에서 이 매개 변수는 NULL이 아니어야 합니다.

Windows 7, Windows Server 2008 R2 이상에서는 dwFlags 매개 변수에 WLAN_SET_EAPHOST_DATA_ALL_USERS 포함되어 있고 dwEapUserDataSize 매개 변수가 0인 경우 이 매개 변수를 NULL로 설정하여 이 프로필에 저장된 자격 증명을 삭제할 수 있습니다.

pReserved

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

반환 값

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

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

반환 코드	설명
ERROR_ACCESS_DENIED	액세스가 거부되었습니다. 호출자가 프로필에 대한 쓰기 권한이 없는 경우 이 값이 반환됩니다.
ERROR_INVALID_PARAMETER	매개 변수가 잘못되었습니다. 다음 조건이 발생하면 이 값이 반환됩니다. hClientHandle 은 NULL입니다. pInterfaceGuid 는 NULL입니다. strProfileName이 NULL임 pvReserved 가 NULL이 아닙니다. Windows Vista 및 Windows Server 2008에서 pbEapUserData 매개 변수가 NULL인 경우 이 값이 반환됩니다. Windows 7, Windows Server 2008 R2 이상에서는 pbEapUserData 매개 변수가 NULL이지만 dwEapUserDataSize 매개 변수가 0이 아니거나 dwFlags 매개 변수에 WLAN_SET_EAPHOST_DATA_ALL_USERS 포함되어 있지 않으면 이 오류가 반환됩니다.
ERROR_INVALID_HANDLE	핸들이 잘못되었습니다. 핸들 테이블에서 hClientHandle 핸들을 찾을 수 없는 경우 이 오류가 반환됩니다.
ERROR_NOT_ENOUGH_MEMORY	이 명령을 처리하는 데 사용할 수 있는 스토리지가 부족합니다.
ERROR_NOT_SUPPORTED	요청이 지원되지 않습니다. 이 값은 프로필 설정이 사용자 데이터의 스토리지를 허용하지 않을 때 반환됩니다. 이 문제는 SSO(Single Signon)를 사용하도록 설정하거나 요청이 이 프로필에 대해 저장된 자격 증명을 삭제할 때 발생할 수 있습니다( pbEapUserData 매개 변수는 NULL이고 dwFlags 매개 변수는 WLAN_SET_EAPHOST_DATA_ALL_USERS 포함하며 dwEapUserDataSize 매개 변수는 0임). Windows 10 Windows Server 2016 이상에서는 인증에 802.1X 이외의 메서드를 사용하는 프로필에서 WlanSetProfileEapUserData 함수가 호출된 경우 이 값이 반환됩니다. SP3이 있는 Windows XP 또는 SP2 클라이언트가 있는 Windows XP용 무선 LAN API에서 이 함수를 호출한 경우에도 이 값이 반환됩니다.
ERROR_SERVICE_NOT_ACTIVE	서비스가 시작되지 않았습니다. 무선 LAN 서비스가 실행되고 있지 않으면 이 값이 반환됩니다.
RPC_STATUS	다양한 오류 코드.

설명

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

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

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

Windows 7, Windows Server 2008 R2 이상에서는 WlanSetProfileEapUserData 함수가 향상되었습니다. dwFlags 매개 변수에 WLAN_SET_EAPHOST_DATA_ALL_USERS 포함된 경우 프로필의 모든 사용자에 대해 EAP 사용자 자격 증명을 설정할 수 있습니다. 프로필의 EAP 사용자 자격 증명도 삭제할 수 있습니다. 프로필에서 EAP 사용자 자격 증명을 삭제하려면 pbEapUserData 매개 변수는 NULL이어야 하고 , dwFlags 매개 변수는 WLAN_SET_EAPHOST_DATA_ALL_USERS 같아야 하며, dwEapUserDataSize 매개 변수는 0이어야 합니다.

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

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

요구 사항

요구 사항	값
지원되는 최소 클라이언트	Windows Vista [데스크톱 앱만 해당]
지원되는 최소 서버	Windows Server 2008 [데스크톱 앱만 해당]
대상 플랫폼	Windows
헤더	wlanapi.h(Wlanapi.h 포함)
라이브러리	Wlanapi.lib
DLL	Wlanapi.dll