IOfflineFilesCache2::RenameItemEx 메서드(cscobj.h)

캐시의 항목 이름을 바꿉니다. 이 메서드는 이름 바꾸기 작업을 즉시 수행하려고 한다는 점을 제외하고 IOfflineFilesCache::RenameItem 메서드와 동일합니다.

구문

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

매개 변수

[in] pszPathOriginal

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

[in] pszPathNew

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

[in] bReplaceIfExists

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

반환 값

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

설명

이 메서드에는 시스템 관리자 권한이 필요하지 않습니다.

이름을 바꿀 항목이 파일 또는 디렉터리인 경우 이름 바꾸기 작업에 대한 파일 시스템 의미 체계를 준수해야 합니다. 파일 또는 자식 파일(디렉터리의 경우)이 이미 열려 있으면 이름 바꾸기가 실패합니다. 또한 이 메서드는 사용자가 이름을 바꿀 항목에 액세스할 수 있는 한 이름 바꾸기를 수행하려고 시도합니다.

항목이 사용 중일 가능성을 최소화해야 하는 경우 대신 IOfflineFilesCache::RenameItem 메서드를 호출합니다.

요구 사항

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

추가 정보

IOfflineFilesCache2