WlanSetProfileCustomUserData 함수(wlanapi.h)

아티클
03/04/2024

WlanSetProfileCustomUserData 함수는 프로필과 연결된 사용자 지정 사용자 데이터를 설정합니다.

구문

DWORD WlanSetProfileCustomUserData(
  [in] HANDLE      hClientHandle,
  [in] const GUID  *pInterfaceGuid,
  [in] LPCWSTR     strProfileName,
  [in] DWORD       dwDataSize,
  [in] const PBYTE pData,
       PVOID       pReserved
);

매개 변수

[in] hClientHandle

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

[in] pInterfaceGuid

인터페이스의 GUID입니다.

[in] strProfileName

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

[in] dwDataSize

pData의 크기(바이트)입니다.

[in] pData

설정할 사용자 데이터에 대한 포인터입니다.

pReserved

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

반환 값

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

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

반환 코드	설명
ERROR_INVALID_PARAMETER	다음 조건 중 하나가 발생했습니다. hClientHandle 이 NULL 이거나 잘못되었습니다. pInterfaceGuid 는 NULL입니다. strProfileName 은 NULL입니다. pReserved 가 NULL이 아닙니다. dwDataSize 가 0이 아니고 pData 가 NULL입니다.
ERROR_INVALID_HANDLE	핸들 테이블에서 hClientHandle 핸들을 찾을 수 없습니다.
ERROR_NOT_SUPPORTED	이 함수는 지원되지 않는 플랫폼에서 호출되었습니다. SP3이 있는 Windows XP 또는 SP2 클라이언트를 사용하는 Windows XP용 무선 LAN API에서 이 함수가 호출된 경우 이 값이 반환됩니다.
RPC_STATUS	다양한 오류 코드.

설명

네이티브 Wifi AutoConfig 서비스에서 사용하는 모든 무선 WLAN 프로필에 대해 Windows는 사용자 지정 사용자 데이터의 개념을 유지 관리합니다. 이 사용자 지정 사용자 데이터는 처음에는 존재하지 않지만 WlanSetProfileCustomUserData 함수를 호출하여 설정할 수 있습니다. WlanSetProfile 함수를 호출하여 프로필이 수정될 때마다 사용자 지정 사용자 데이터가 비워지도록 다시 설정됩니다.

사용자 지정 사용자 데이터가 설정되면 WlanGetProfileCustomUserData 함수를 사용하여 이 데이터에 액세스할 수 있습니다.

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

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

요구 사항

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