IFileOperation::RenameItems 메서드(shobjidl_core.h)

새 표시 이름을 지정할 항목 집합을 선언합니다. 모든 항목에는 동일한 이름이 지정됩니다.

구문

HRESULT RenameItems(
  [in] IUnknown *pUnkItems,
  [in] LPCWSTR  pszNewName
);

매개 변수

[in] pUnkItems

형식: IUnknown*

이름을 바꿀 항목 그룹을 나타내는 IShellItemArray, IDataObject 또는 IEnumShellItems 개체의 IUnknown에 대한 포인터입니다. 또한 IPersistIDList 개체를 가리키면 단일 항목을 나타내며 IFileOperation::RenameItem과 동일한 함수를 효과적으로 수행할 수 있습니다.

[in] pszNewName

형식: LPCWSTR

항목의 새 표시 이름에 대한 포인터입니다. null로 끝나는 유니코드 문자열입니다.

반환 값

형식: HRESULT

메서드가 성공하면 S_OK를 반환하고, 그러지 않으면 HRESULT 오류 코드를 반환합니다.

설명

pUnkItems의 컬렉션에 있는 항목 중 하나 이상이 동일한 폴더에 있는 경우 이름이 바뀐 파일에는 instance newfile(1).txt, newfile(2).txt 및 newfile(3).txt 대해 이름이 바뀐 파일에 괄호 안에 숫자가 추가됩니다.

이 메서드는 항목의 이름을 바꾸는 것이 아니라 이름을 바꿀 항목만 선언합니다. 개체 그룹의 이름을 바꾸려면 적어도 여기에 자세히 설명된 호출 시퀀스를 만들어야 합니다.

1. IFileOperation::RenameItems를 호출하여 원본 파일 또는 폴더와 새 이름을 선언합니다.
2. IFileOperation::P erformOperations를 호출하여 이름 바꾸기 작업을 시작합니다.

요구 사항

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

추가 정보

IFileOperation

IFileOperation::RenameItem