WlanUIEditProfile 함수(wlanapi.h)

무선 프로필 UI(사용자 인터페이스)를 표시합니다. 이 UI는 무선 네트워크 프로필의 고급 설정을 보고 편집하는 데 사용됩니다.

구문

DWORD WlanUIEditProfile(
  [in]  DWORD             dwClientVersion,
  [in]  LPCWSTR           wstrProfileName,
  [in]  GUID              *pInterfaceGuid,
  [in]  HWND              hWnd,
  [in]  WL_DISPLAY_PAGES  wlStartPage,
        PVOID             pReserved,
  [out] PWLAN_REASON_CODE pWlanReasonCode
);

매개 변수

[in] dwClientVersion

클라이언트에서 지원하는 가장 높은 버전의 WLAN API를 지정합니다. WLAN_UI_API_VERSION 이외의 값은 무시됩니다.

[in] wstrProfileName

보거나 편집할 프로필의 이름을 포함합니다. 프로필 이름은 대/소문자를 구분합니다. 이 문자열은 NULL로 종료되어야 합니다.

제공된 프로필은 pInterfaceGuid 인터페이스에 있어야 합니다. 즉, 프로필이 이전에 만들어지고 프로필 저장소에 저장되어야 하며 제공된 인터페이스에 대해 프로필이 유효해야 합니다.

[in] pInterfaceGuid

인터페이스의 GUID입니다.

[in] hWnd

UI 표시를 요청하는 애플리케이션 창의 핸들입니다.

[in] wlStartPage

UI 대화 상자가 나타날 때 활성 탭을 지정하는 WL_DISPLAY_PAGES 값입니다.

pReserved

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

[out] pWlanReasonCode

UI 표시가 실패한 이유를 나타내는 WLAN_REASON_CODE 값에 대한 포인터입니다.

반환 값

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

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

반환 코드	설명
ERROR_INVALID_PARAMETER	제공된 매개 변수 중 하나가 잘못되었습니다.
ERROR_NOT_SUPPORTED	이 함수는 지원되지 않는 플랫폼에서 호출되었습니다. SP3이 있는 Windows XP 또는 SP2 클라이언트를 사용하는 Windows XP용 무선 LAN API에서 이 함수가 호출된 경우 이 값이 반환됩니다.
RPC_STATUS	다양한 오류 코드.

설명

WlanUIEditProfile이 ERROR_SUCCESS 반환하는 경우 UI에서 수행한 프로필의 변경 내용은 프로필 저장소에 저장됩니다.

요구 사항

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