IStorage::RenameElement 메서드(objidl.h)
RenameElement 메서드는 이 스토리지 개체에서 지정된 하위 저장소 또는 스트림의 이름을 바꿉니다.
구문
HRESULT RenameElement(
[in] const OLECHAR *pwcsOldName,
[in] const OLECHAR *pwcsNewName
);
매개 변수
[in] pwcsOldName
변경할 하위 저장소 또는 스트림의 이름을 포함하는 와이드 문자 null로 끝나는 유니코드 문자열에 대한 포인터입니다.
참고CreateStorage 또는 CreateStream에서 만든 pwcsName은 문자열 종결자를 포함하지 않고 길이가 31자를 초과하면 안 됩니다.
[in] pwcsNewName
지정된 하위 저장소 또는 스트림의 새 이름을 포함하는 와이드 문자 null로 끝나는 유니코드 문자열에 대한 포인터입니다.
참고CreateStorage 또는 CreateStream에서 만든 pwcsName은 문자열 종결자를 포함하지 않고 길이가 31자를 초과하면 안 됩니다.
반환 값
이 메서드는 이러한 값 중 하나를 반환할 수 있습니다.
| 반환 코드 | 설명 |
|---|---|
| S_OK | 요소의 이름이 성공적으로 바뀌었습니다. |
| E_PENDING | 비동기 스토리지만 해당: 요소의 데이터 일부 또는 전체를 현재 사용할 수 없습니다. |
| STG_E_ACCESSDENIED | 호출자에게 요소 이름을 바꾸는 데 필요한 충분한 권한이 없습니다. |
| STG_E_FILENOTFOUND | 지정된 이전 이름을 가진 요소가 없습니다. |
| STG_E_FILEALREADYEXISTS | 새 이름으로 지정된 요소가 이미 있습니다. |
| STG_E_INSUFFICIENTMEMORY | 메모리 부족으로 요소의 이름이 바뀌지 않았습니다. |
| STG_E_INVALIDNAME | 이름 중 하나에 대한 값이 잘못되었습니다. |
| STG_E_INVALIDPOINTER | 요소에 대해 지정된 포인터가 잘못되었습니다. |
| STG_E_INVALIDPARAMETER | 매개 변수 중 하나가 잘못되었습니다. |
| STG_E_REVERTED | 스토리지 개체는 트랜잭션 트리에서 위의 되돌리기 작업에 의해 무효화되었습니다. |
| STG_E_TOOMANYOPENFILES | 열려 있는 파일이 너무 많기 때문에 요소의 이름이 바뀌지 않았습니다. |
설명
IStorage::RenameElement 는 이 스토리지 개체에서 지정된 하위 저장소 또는 스트림의 이름을 바꿉니다. 스토리지 개체의 요소는 열려 있는 동안 이름을 바꿀 수 없습니다. 스토리지가 트랜잭션 모드로 열려 있는 경우 이름 바꾸기 작업은 변경 내용을 커밋할 수 있습니다.
IStorage::RenameElement 메서드는 트랜잭션 모드에서 열린 스토리지 개체가 있는 낮은 메모리에서 작동하도록 보장되지 않습니다. 직접 모드에서 작동할 수 있습니다.
요구 사항
| 요구 사항 | 값 |
|---|---|
| 지원되는 최소 클라이언트 | Windows 2000 Professional [데스크톱 앱 | UWP 앱] |
| 지원되는 최소 서버 | Windows 2000 Server [데스크톱 앱 | UWP 앱] |
| 대상 플랫폼 | Windows |
| 헤더 | objidl.h |
| 라이브러리 | Uuid.lib |
| DLL | Ole32.dll |