다음을 통해 공유

WlanRenameProfile 함수(wlanapi.h)

  • 아티클

WlanRenameProfile 함수는 지정된 프로필의 이름을 바꿉니다.

구문

DWORD WlanRenameProfile(
  [in] HANDLE     hClientHandle,
  [in] const GUID *pInterfaceGuid,
  [in] LPCWSTR    strOldProfileName,
  [in] LPCWSTR    strNewProfileName,
       PVOID      pReserved
);

매개 변수

[in] hClientHandle

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

[in] pInterfaceGuid

인터페이스의 GUID입니다.

[in] strOldProfileName

변경할 프로필 이름입니다.

[in] strNewProfileName

프로필의 새 이름입니다.

pReserved

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

반환 값

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

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

반환 코드 설명
ERROR_INVALID 매개 변수
 hClientHandle 이 NULL 이거나 유효하지 않거나, pInterfaceGuid 가 NULL이거나, strOldProfileName 이 NULL이거나, strNewProfileName 이 NULL이거나, pReserved 가 NULL이 아닙니다.
ERROR_INVALID_HANDLE
 핸들 테이블에 hClientHandle 핸들을 찾을 수 없습니다.
ERROR_NOT_FOUND
 strOldProfileName으로 지정된 프로필이 프로필 저장소에 없습니다.
ERROR_ACCESS_DENIED
 호출자에게 프로필 이름을 바꿀 수 있는 충분한 권한이 없습니다.
ERROR_NOT_SUPPORTED
 이 함수는 지원되지 않는 플랫폼에서 호출되었습니다. SP3이 있는 Windows XP 또는 SP2 클라이언트가 있는 Windows XP용 무선 LAN API에서 이 함수를 호출한 경우 이 값이 반환됩니다.
RPC_STATUS
 다양한 오류 코드.

요구 사항

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

참고 항목

WlanDeleteProfile

WlanGetProfile

WlanSetProfile