다음을 통해 공유

ITransferSource::RenameItem 메서드(shobjidl_core.h)

  • 아티클

새 이름으로 IShellItem 을 반환하여 항목의 이름을 변경합니다.

구문

HRESULT RenameItem(
  [in]  IShellItem            *psiSource,
  [in]  LPCWSTR               pszNewName,
  [in]  TRANSFER_SOURCE_FLAGS flags,
  [out] IShellItem            **ppsiNewDest
);

매개 변수

[in] psiSource

형식: IShellItem*

이름을 바꿀 IShellItem 개체에 대한 포인터입니다.

[in] pszNewName

형식: LPCWSTR

새 이름을 포함하는 null로 끝나는 유니코드 문자열에 대한 포인터입니다.

[in] flags

형식: TRANSFER_SOURCE_FLAGS

파일 작업을 제어하는 플래그입니다. 하나 이상의 TRANSFER_SOURCE_FLAGS 상수입니다.

[out] ppsiNewDest

형식: IShellItem**

이 메서드가 반환되면 에는 IShellItem 개체에 대한 포인터의 주소가 포함됩니다.

반환 값

형식: HRESULT

다음 중 하나 또는 오류 코드를 반환합니다.

반환 코드 설명
COPYENGINE_S_YES
 사용자가 대화 상자에 "예"라고 응답했습니다.
COPYENGINE_S_USER_RETRY
 사용자가 응답하여 현재 작업을 다시 시도했습니다.
COPYENGINE_S_USER_IGNORED
 사용자가 대화 상자에 "아니요"라고 응답했습니다.
COPYENGINE_S_MERGE
 사용자가 병합 폴더에 응답했습니다.
COPYENGINE_S_USER_RETRY_WITH_NEW_NAME
 사용자가 새 이름으로 파일을 다시 시도하도록 응답했습니다.
COPYENGINE_S_DONT_PROCESS_CHILDREN
 자식 항목은 처리해서는 안 됩니다.
COPYENGINE_S_PENDING
 오류가 큐에 대기 중이며 나중에 표시됩니다.
COPYENGINE_E_USER_CANCELLED
 사용자가 현재 작업을 취소했습니다.
COPYENGINE_E_REQUIRES_ELEVATION
 작업에는 상승된 권한이 필요합니다.

요구 사항

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