IFileOperation::RenameItem 메서드(shobjidl_core.h)
새 표시 이름을 지정할 단일 항목을 선언합니다.
구문
HRESULT RenameItem(
[in] IShellItem *psiItem,
[in] LPCWSTR pszNewName,
[in] IFileOperationProgressSink *pfopsItem
);
매개 변수
[in] psiItem
형식: IShellItem*
원본 항목을 지정하는 IShellItem 에 대한 포인터입니다.
[in] pszNewName
형식: LPCWSTR
항목의 새 표시 이름 에 대한 포인터입니다. null로 끝나는 유니코드 문자열입니다.
[in] pfopsItem
형식: IFileOperationProgressSink*
상태 및 실패 알림에 사용할 IFileOperationProgressSink 개체에 대한 포인터입니다. 전체 작업에 대해 IFileOperation::Advise를 호출하면 진행률 상태 및 이름 바꾸기 작업에 대한 오류 알림이 포함되므로 이 매개 변수를 NULL로 설정합니다.
반환 값
형식: HRESULT
메서드가 성공하면 S_OK를 반환하고, 그러지 않으면 HRESULT 오류 코드를 반환합니다.
설명
이 메서드는 항목의 이름을 바꾸는 것이 아니라 이름을 바꿀 항목만 선언합니다. 개체의 이름을 바꾸려면 적어도 여기에 자세히 설명된 호출 시퀀스를 만들어야 합니다.
- IFileOperation::RenameItem을 호출하여 새 이름을 선언합니다.
- IFileOperation::P erformOperations를 호출하여 이름 바꾸기 작업을 시작합니다.
요구 사항
| 지원되는 최소 클라이언트 | Windows Vista [데스크톱 앱만 해당] |
| 지원되는 최소 서버 | Windows Server 2008 [데스크톱 앱만 해당] |
| 대상 플랫폼 | Windows |
| 헤더 | shobjidl_core.h(Shobjidl.h 포함) |