IOfflineFilesCache::RenameItem 메서드(cscobj.h)

캐시의 항목 이름을 바꿉니다. 이 메서드는 다음 시스템 다시 시작에 이름을 바꿀 경로에 대한 오프라인 파일 서비스를 사용하여 요청을 기록합니다.

구문

HRESULT RenameItem(
  [in] LPCWSTR pszPathOriginal,
  [in] LPCWSTR pszPathNew,
  [in] BOOL    bReplaceIfExists
);

매개 변수

[in] pszPathOriginal

이름을 바꿀 항목(서버, 공유, 파일 또는 디렉터리)의 정규화된 UNC 경로입니다.

[in] pszPathNew

pszPathOriginal이 가리키는 항목이 캐시에 있는 경우 pszPathOriginal을 대체할 새 경로입니다.

[in] bReplaceIfExists

이 매개 변수는 나중에 사용하도록 예약되어 있습니다.

반환 값

성공하면 S_OK 반환하고, 그렇지 않으면 오류 값을 반환합니다.

설명

이 방법을 사용하려면 시스템 관리자 권한이 필요합니다.

참고 오프라인 파일 캐시에 이름 바꾸기 작업을 적용하려면 시스템을 다시 시작해야 합니다.

 

pszPathNew 매개 변수가 참조하는 경로가 오프라인 파일 캐시에 이미 있는 경우 이 메서드는 실패합니다.

Windows 8 및 Windows Server 2012 시작하여 IOfflineFilesCache2::RenameItemEx 메서드를 사용하여 항목 이름을 바꿀 수도 있습니다. 시스템 관리자 권한 또는 시스템 다시 시작이 필요하지 않습니다. 그러나 항목이 현재 사용 중인 경우 실패합니다.

요구 사항

요구 사항	값
지원되는 최소 클라이언트	Windows Vista
지원되는 최소 서버	Windows Server 2008
대상 플랫폼	Windows
헤더	cscobj.h
DLL	CscSvc.dll; CscObj.dll

추가 정보

IOfflineFilesCache

IOfflineFilesCache2::RenameItemEx